Partager via


constantes DEVICE_STATE_XXX

Les constantes DEVICE_STATE_XXX indiquent l’état actuel d’un appareil de point de terminaison audio.

Constante/valeur Description
DEVICE_STATE_ACTIVE
0x00000001
Le périphérique de point de terminaison audio est actif. Autrement dit, l’adaptateur audio qui se connecte au périphérique de point de terminaison est présent et activé. En outre, si l’appareil de point de terminaison se connecte à une prise jack sur l’adaptateur, l’appareil de point de terminaison est branché.
DEVICE_STATE_DISABLED
0x00000002
Le périphérique de point de terminaison audio est désactivé. L’utilisateur a désactivé l’appareil dans le panneau de configuration multimédia Windows, Mmsys.cpl. Pour plus d'informations, consultez la section Notes.
DEVICE_STATE_NOTPRESENT
0x00000004
Le périphérique de point de terminaison audio n’est pas présent, car l’adaptateur audio qui se connecte au périphérique de point de terminaison a été supprimé du système ou l’utilisateur a désactivé l’appareil adaptateur dans Gestionnaire de périphériques.
DEVICE_STATE_UNPLUGGED
0x00000008
Le périphérique de point de terminaison audio est débranché. L’adaptateur audio qui contient la prise jack de l’appareil de point de terminaison est présent et activé, mais le périphérique de point de terminaison n’est pas branché sur la prise jack. Seul un appareil avec détection de présence jack peut se trouver dans cet état. Pour plus d’informations sur la détection de présence jack, consultez Appareils de point de terminaison audio.
DEVICE_STATEMASK_ALL
0x0000000F
Inclut les appareils de point de terminaison audio dans tous les états actifs, désactivés, non présents et débranchés.

Notes

Les méthodes IMMDeviceEnumerator::EnumAudioEndpoints, IMMDevice::GetState et IMMNotificationClient::OnDeviceStateChanged utilisent les constantes DEVICE_STATE_XXX. Ces méthodes permettent aux clients d’obtenir des informations sur les appareils de point de terminaison qui se trouvent dans l’un des états représentés par les constantes DEVICE_STATE_XXX.

Toutefois, un client peut ouvrir un flux (par exemple, en obtenant une interface IAudioClient pour l’appareil) uniquement sur un appareil à l’état DEVICE_STATE_ACTIVE.

Le panneau de configuration multimédia Windows, Mmsys.cpl, affiche les périphériques de point de terminaison audio dans le système. La désactivation d’un appareil dans Mmsys.cpl masque l’appareil des mécanismes de découverte des appareils dans les API audio de niveau supérieur, mais elle n’invalide pas les objets de flux qu’un client peut avoir instanciés avant la désactivation de l’appareil. Par exemple, si un flux est lu sur l’appareil lorsque l’utilisateur le désactive dans Mmsys.cpl, le flux continue à être lu sans interruption.

En revanche, la désactivation d’un appareil dans Gestionnaire de périphériques supprime efficacement l’appareil du système.

Pour utiliser Mmsys.cpl pour afficher les périphériques de rendu, ouvrez une fenêtre d’invite de commandes et entrez la commande suivante :

mmsys.cpl de contrôle,,0

Pour afficher les appareils de capture, entrez la commande suivante :

mmsys.cpl de contrôle,,1

Vous pouvez également afficher les périphériques de rendu ou les périphériques de capture dans Mmsys.cpl en cliquant avec le bouton droit sur l’icône du haut-parleur dans la zone de notification, qui se trouve sur le côté droit de la barre des tâches, et en sélectionnant Périphériques de lecture ou Périphériques d’enregistrement.

Mmsys.cpl affiche toujours les appareils de point de terminaison qui sont à l’état DEVICE_STATE_ACTIVE. En outre, il peut être configuré pour afficher les appareils désactivés et déconnectés.

Pour afficher les appareils de point de terminaison qui se trouvent dans les états DEVICE_STATE_DISABLED et DEVICE_STATE_NOTPRESENT, cliquez avec le bouton droit dans la fenêtre Mmsys.cpl et sélectionnez l’option Afficher les appareils désactivés .

Pour afficher les appareils de point de terminaison qui sont à l’état DEVICE_STATE_UNPLUGGED, cliquez avec le bouton droit dans la fenêtre Mmsys.cpl et sélectionnez l’option Afficher les appareils déconnectés .

Pour afficher uniquement les appareils de point de terminaison qui sont à l’état DEVICE_STATE_ACTIVE, désélectionnez les options Afficher les appareils désactivés et Afficher les appareils déconnectés .

Pour activer ou désactiver un appareil de point de terminaison dans Mmsys.cpl, cliquez sur Lecture ou enregistrement, selon qu’il s’agit d’un appareil de lecture ou d’enregistrement. Ensuite, sélectionnez l’appareil, puis cliquez sur Propriétés. Dans la fenêtre Propriétés, en regard de Utilisation de l’appareil, sélectionnez Utiliser cet appareil (activer) ou Ne pas utiliser cet appareil (désactiver).

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2008 [applications de bureau uniquement]
En-tête
Mmdeviceapi.h

Voir aussi

Constantes audio principales

IMMDevice::GetState

IMMDeviceEnumerator Interface

IMMDeviceEnumerator::EnumAudioEndpoints

IMMNotificationClient::OnDeviceStateChanged