Propriétés du point de terminaison audio
Le fichier d’en-tête Mmdeviceapi.h définit plusieurs propriétés d’appareils de point de terminaison audio dans Windows Vista et versions ultérieures. Le service audio Windows définit les valeurs de ces propriétés. Les clients peuvent lire ces propriétés, mais ne doivent pas les définir. Les valeurs de propriété sont stockées sous forme de structures PROPVARIANT.
La façon recommandée de lire les propriétés d’un périphérique d’entrée audio consiste à utiliser les API dans l’espace de nomsWindows.Devices.Enumeration. Ces API sont prises en charge pour les applications du Windows Store et les applications de bureau. Pour les applications de bureau existantes qui lisent les propriétés de l’appareil à l’aide de l’interfaceIMMDevice, consultez Propriétés de l’appareil. IMMDevice n’est pas pris en charge pour les applications du Windows Store.
Pour obtenir des exemples de code qui montrent comment accéder aux propriétés d’un appareil de point de terminaison audio, consultez les rubriques suivantes :
- événements d’appareil
- rôles d’appareil pour les applications DirectSound
Pour plus d’informations sur PROPVARIANT, consultez la documentation du Kit de développement logiciel (SDK) Windows.
Les propriétés suivantes sont spécifiques aux appareils de point de terminaison audio.
| Propriété | Description |
|---|---|
| PKEY_AudioEndpoint_Association | Associe une catégorie de broche de streaming de noyau (KS) à un appareil de point de terminaison audio. |
| PKEY_AudioEndpoint_ControlPanelPageProvider | Spécifie le CLSID du fournisseur inscrit de l’extension de propriétés de l’appareil pour l’appareil de point de terminaison audio. |
| PKEY_AudioEndpoint_Disable_SysFx | Indique si les effets système sont activés dans le flux en mode partagé qui circule vers ou depuis l’appareil de point de terminaison audio. |
| PKEY_AudioEndpoint_FormFactor | Indique les attributs physiques de l’appareil de point de terminaison audio. |
| PKEY_AudioEndpoint_FullRangeSpeakers | Spécifie le masque de configuration de canal pour les haut-parleurs de plage complète connectés à l’appareil de point de terminaison audio. |
| PKEY_AudioEndpoint_GUID | Fournit l’identificateur de l’appareil DirectSound qui correspond à l’appareil de point de terminaison audio. |
| PKEY_AudioEndpoint_PhysicalSpeakers | Définit la configuration du haut-parleur physique pour l’appareil de point de terminaison audio. |
| PKEY_AudioEngine_DeviceFormat | Spécifie le format de l’appareil, qui est le format utilisé par le moteur audio pour le flux en mode partagé qui circule vers ou depuis l’appareil de point de terminaison audio. |
| PKEY_AudioEngine_OEMFormat | Spécifie le format par défaut de l’appareil utilisé pour le rendu ou la capture d’un flux. Les valeurs sont remplies par l’OEM dans un fichier .inf. |
| PKEY_AudioEndpoint_Supports_EventDriven_Mode | Indique si le point de terminaison prend en charge le mode piloté par les événements. Les valeurs sont remplies par l’OEM dans un fichier .inf. |
| PKEY_AudioEndpoint_JackSubType | Contient un GUID de catégorie de sortie pour un appareil de point de terminaison audio. |
Les API audio principales prennent en charge des propriétés supplémentaires qui ne s’appliquent pas exclusivement aux appareils de point de terminaison audio. Pour plus d’informations sur ces propriétés supplémentaires, consultez Propriétés de l’appareil.