Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
À compter de Windows Server 2008 R2, vous pouvez implémenter un énumérateur de point de terminaison audio distant personnalisé dans le cadre d’un fournisseur de protocole Bureau à distance. Un fournisseur de protocole Bureau à distance peut utiliser un énumérateur de point de terminaison audio personnalisé pour récupérer une collection de points de terminaison audio qui ont un ensemble spécifique de fonctionnalités.
Pour implémenter un énumérateur de point de terminaison audio distant personnalisé
- Votre solution d’énumérateur de point de terminaison personnalisée doit implémenter quatre types principaux d’objets : objets d’énumérateur d’appareil, objets de collection d’appareils, objets d’appareil et objets de magasin de propriétés.
| Type d’objet | Description |
|---|---|
| Objet énumérateur de périphériques |
Un objet d’énumération des périphériques fournit la fonctionnalité d’énumération des points de terminaison. Il expose des méthodes qui retournent un point de terminaison par défaut et des collections de points de terminaison spécifiées. Par exemple, selon les critères spécifiés, l’énumérateur peut retourner des points de terminaison de communication, des points de terminaison de lecture ou des points de terminaison de capture. L’objet énumérateur d’appareil doit implémenter l’interface IMMDeviceEnumerator . |
| Objet de collection d’appareils |
Un objet de collection d’appareils représente une collection d’appareils audio. Il doit implémenter l’interface IMMDeviceCollection . |
| Objet Device |
Un objet d’appareil représente un périphérique audio particulier. Il fournit l’accès au magasin de propriétés de l’appareil audio et expose les interfaces de lecture et de capture audio disponibles sur l’appareil. L’objet d’appareil doit implémenter les interfaces IMMDevice et IMMEndpoint . |
| Objet de stockage de propriétés |
Un objet de stockage de propriétés fournit les propriétés associées à un périphérique audio. Certaines de ces propriétés sont utilisées par le système, mais les applications peuvent également stocker des propriétés arbitraires avec le point de terminaison audio. Tous les appareils audio ont les trois propriétés suivantes : L’objet de magasin de propriétés doit implémenter l’interface IPropertyStore . |
- L’énumérateur de point de terminaison personnalisé doit être implémenté dans une DLL qui peut être chargée dans le système audio et d’autres applications. La DLL doit être signée afin que les processus sécurisés puissent le charger. La DLL doit implémenter et exporter la fonction GetTSAudioEndpointEnumeratorForSession , qui agit comme un point d’entrée vers l’énumérateur de point de terminaison personnalisé.
Le service Bureau à distance Services appelle la méthode QueryProperty et définit le paramètre QueryType sur WTS_QUERY_AUDIOENUM_DLL pour récupérer le nom de l’objet énumérateur.
Les objets d’énumérateur personnalisés utilisent des interfaces de type COM et un mécanisme de comptage de référence de type COM, mais ils ne sont pas des objets COM vrais. L’énumérateur de point de terminaison personnalisé doit avoir la possibilité d’utiliser des interfaces audio héritées utilisées par les applications qui ne prennent pas en charge COM. Pour cette raison, l’énumérateur de point de terminaison personnalisé ne doit pas s’appuyer sur le mécanisme de gestion du cycle de vie de COM. Les composants qui utilisent votre énumérateur de point de terminaison audio, tels que MMDevAPI.dll, chargent la DLL de l’énumérateur de point de terminaison personnalisé à la demande des applications utilisateur, et ils ne déchargent pas cet énumérateur tant que celui-ci conserve une référence à un objet d’énumération de périphériques, à un objet de collection de périphériques, à un objet périphérique ou à un objet de magasin de propriétés. Toutefois, il n’est pas possible pour ces consommateurs de suivre les références à d’autres types d’objets appartenant à l’énumérateur de point de terminaison personnalisé. En conséquence, nous recommandons que votre énumérateur de point de terminaison personnalisé ne crée pas d’objets qui pourraient survivre à ces quatre types d’objets.
Pour implémenter un point de terminaison audio personnalisé
Pour implémenter un énumérateur d’appareil audio personnalisé, vous devez implémenter un point de terminaison audio personnalisé. La façon dont vos appareils audio personnalisés sont liés consiste à utiliser les deux instructions suivantes :
IMMDevice::Activate(IAudioOutputEndpointRT)IMMDevice::Activate(IAudioInputEndpointRT)
Nous ne vous attendons pas à implémenter la liste complète des interfaces IMMDevice ::Activate dans votre énumérateur d’appareil audio personnalisé. Au lieu de cela, vous devez implémenter IAudioOutputEndpointRT et IAudioInputEndpointRT. Vous pouvez éventuellement implémenter quelques exemples supplémentaires, tels que IAudioEndpointVolume. Pour toute interface que vous n’implémentez pas, vous devez retourner E_NOINTERFACE (vous devez utiliser ce code d’échec spécifique). Windows revient ensuite à une implémentation de stock de l’interface (par exemple, IAudioClient2).
Pour obtenir une documentation de référence supplémentaire sur l’implémentation et l’inscription de points de terminaison audio, consultez IAudioInputEndpointRT. Pour obtenir un diagramme montrant le fonctionnement de WASAPI, consultez User-Mode Composants audio. Notez que l’audio en mode utilisateur est nouveau depuis Windows Server 2008.