Partager via

Propriétés du point de terminaison audio

  • Article

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.

Appareils de point de terminaison audio

Guide de référence de programmation