Compartir a través de


constantes de DEVICE_STATE_XXX

Las constantes DEVICE_STATE_XXX indican el estado actual de un dispositivo de punto de conexión de audio.

Constante o valor Descripción
DEVICE_STATE_ACTIVE
0x00000001
El dispositivo de punto de conexión de audio está activo. Es decir, el adaptador de audio que se conecta al dispositivo de punto de conexión está presente y habilitado. Además, si el dispositivo de punto de conexión se conecta a un conector en el adaptador, el dispositivo de punto de conexión se conecta.
DEVICE_STATE_DISABLED
0x00000002
El dispositivo de punto de conexión de audio está deshabilitado. El usuario ha deshabilitado el dispositivo en el panel de control multimedia de Windows, Mmsys.cpl. Para obtener más información, vea la sección Comentarios.
DEVICE_STATE_NOTPRESENT
0x00000004
El dispositivo de punto de conexión de audio no está presente porque el adaptador de audio que se conecta al dispositivo de punto de conexión se ha quitado del sistema o el usuario ha deshabilitado el dispositivo adaptador en Administrador de dispositivos.
DEVICE_STATE_UNPLUGGED
0x00000008
El dispositivo de punto de conexión de audio está desconectado. El adaptador de audio que contiene el conector para el dispositivo de punto de conexión está presente y habilitado, pero el dispositivo de punto de conexión no está conectado al conector. Solo un dispositivo con detección de presencia de jack puede estar en este estado. Para obtener más información sobre la detección de presencia de jack, consulte Dispositivos de punto de conexión de audio.
DEVICE_STATEMASK_ALL
0x0000000F
Incluye dispositivos de punto de conexión de audio en todos los estados activos, deshabilitados, no presentes y desconectados.

Comentarios

Los métodos IMMDeviceEnumerator::EnumAudioEndpoints, IMMDevice::GetState e IMMNotificationClient::OnDeviceStateChanged usan las constantes DEVICE_STATE_XXX. Estos métodos permiten a los clientes obtener información sobre los dispositivos de punto de conexión que se encuentran en cualquiera de los estados representados por las constantes DEVICE_STATE_XXX.

Sin embargo, un cliente puede abrir una secuencia (por ejemplo, obteniendo una interfaz IAudioClient para el dispositivo) solo en un dispositivo que esté en estado DEVICE_STATE_ACTIVE.

El panel de control multimedia de Windows, Mmsys.cpl, muestra los dispositivos de punto de conexión de audio en el sistema. Al deshabilitar un dispositivo en Mmsys.cpl se oculta el dispositivo de los mecanismos de detección de dispositivos en las API de audio de nivel superior, pero no invalida ningún objeto de secuencia que un cliente haya creado una instancia antes de deshabilitar el dispositivo. Por ejemplo, si una secuencia se reproduce en el dispositivo cuando el usuario la deshabilita en Mmsys.cpl, la secuencia continúa reproduciendo sin interrupciones.

Por el contrario, deshabilitar un dispositivo en Administrador de dispositivos quita eficazmente el dispositivo del sistema.

Para usar Mmsys.cpl para ver los dispositivos de representación, abra una ventana del símbolo del sistema y escriba el siguiente comando:

control mmsys.cpl,0

Para ver los dispositivos de captura, escriba el siguiente comando:

control mmsys.cpl,1

Como alternativa, puede ver los dispositivos de representación o los dispositivos de captura en Mmsys.cpl haciendo clic con el botón derecho en el icono del altavoz en el área de notificación, que se encuentra en el lado derecho de la barra de tareas y seleccionando Dispositivos de reproducción o Dispositivos de grabación.

Mmsys.cpl siempre muestra los dispositivos de punto de conexión que están en estado de DEVICE_STATE_ACTIVE. Además, se puede configurar para mostrar dispositivos deshabilitados y desconectados.

Para ver los dispositivos de punto de conexión que se encuentran en los estados DEVICE_STATE_DISABLED y DEVICE_STATE_NOTPRESENT, haga clic con el botón derecho en la ventana Mmsys.cpl y seleccione la opción Mostrar dispositivos deshabilitados .

Para ver los dispositivos de punto de conexión que están en estado DEVICE_STATE_UNPLUGGED, haga clic con el botón derecho en la ventana Mmsys.cpl y seleccione la opción Mostrar dispositivos desconectados .

Para ver solo los dispositivos de punto de conexión que están en estado DEVICE_STATE_ACTIVE, anule la selección de las opciones Mostrar dispositivos deshabilitados y Mostrar dispositivos desconectados .

Para habilitar o deshabilitar un dispositivo de punto de conexión en Mmsys.cpl, haga clic en Reproducción o Grabación, en función de si el dispositivo es una reproducción o un dispositivo de grabación. A continuación, seleccione el dispositivo y haga clic en Propiedades. En la ventana Propiedades, junto a Uso del dispositivo, seleccione Usar este dispositivo (habilitar) o No usar este dispositivo (deshabilitar).

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado
Mmdeviceapi.h

Consulte también

Constantes de audio principales

IMMDevice::GetState

IMMDeviceEnumerator (Interfaz)

IMMDeviceEnumerator::EnumAudioEndpoints

IMMNotificationClient::OnDeviceStateChanged