Propriétés du point de terminaison audio
Le fichier d’en-tête Mmdeviceapi.h définit plusieurs propriétés des 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 en tant que structures PROPVARIANT .
La méthode recommandée pour lire les propriétés d’un périphérique d’entrée audio consiste à utiliser les API dans l’espace de noms Windows.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’interface IMMDevice , 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 :
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 broches 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 device-properties 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 du périphérique 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 au périphérique de point de terminaison audio. |
| PKEY_AudioEndpoint_GUID | Fournit l’identificateur d’appareil DirectSound qui correspond à l’appareil de point de terminaison audio. |
| PKEY_AudioEndpoint_PhysicalSpeakers | Définit la configuration du haut-parleur physique pour le périphérique 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 à partir de 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.