Constantes DEVICE_STATE_XXX

As constantes DEVICE_STATE_XXX indicam o estado atual de um dispositivo de ponto de extremidade de áudio.

Constante/valor Descrição
DEVICE_STATE_ACTIVE
0x00000001
O dispositivo de ponto de extremidade de áudio está ativo. Ou seja, o adaptador de áudio que se conecta ao dispositivo de ponto de extremidade está presente e habilitado. Além disso, se o dispositivo de ponto de extremidade se conectar a uma tomada no adaptador, o dispositivo de ponto de extremidade será conectado.
DEVICE_STATE_DISABLED
0x00000002
O dispositivo de ponto de extremidade de áudio está desabilitado. O usuário desabilitou o dispositivo no painel de controle multimídia do Windows, Mmsys.cpl. Para obter mais informações, consulte Comentários.
DEVICE_STATE_NOTPRESENT
0x00000004
O dispositivo de ponto de extremidade de áudio não está presente porque o adaptador de áudio que se conecta ao dispositivo de ponto de extremidade foi removido do sistema ou o usuário desabilitou o dispositivo adaptador no Gerenciador de Dispositivos.
DEVICE_STATE_UNPLUGGED
0x00000008
O dispositivo de ponto de extremidade de áudio está desconectado. O adaptador de áudio que contém a tomada para o dispositivo de ponto de extremidade está presente e habilitado, mas o dispositivo de ponto de extremidade não está conectado à tomada. Somente um dispositivo com detecção de presença de jack pode estar nesse estado. Para obter mais informações sobre a detecção de presença de jack, consulte Dispositivos de ponto de extremidade de áudio.
DEVICE_STATEMASK_ALL
0x0000000F
Inclui dispositivos de ponto de extremidade de áudio em todos os estados ativos, desabilitados, não presentes e desconectados.

Comentários

Os métodos IMMDeviceEnumerator::EnumAudioEndpoints, IMMDevice::GetState e IMMNotificationClient::OnDeviceStateChanged usam as constantes DEVICE_STATE_XXX. Esses métodos permitem que os clientes obtenham informações sobre dispositivos de ponto de extremidade que estão em qualquer um dos estados representados pelas constantes DEVICE_STATE_XXX.

No entanto, um cliente pode abrir um fluxo (por exemplo, obtendo uma interface IAudioClient para o dispositivo) somente em um dispositivo que esteja no estado DEVICE_STATE_ACTIVE.

O painel de controle multimídia do Windows, Mmsys.cpl, exibe os dispositivos de ponto de extremidade de áudio no sistema. Desabilitar um dispositivo em Mmsys.cpl oculta o dispositivo dos mecanismos de descoberta de dispositivo em APIs de áudio de nível superior, mas não invalida nenhum objeto de fluxo que um cliente possa ter instanciado antes de o dispositivo ser desabilitado. Por exemplo, se um fluxo estiver sendo reproduzido no dispositivo quando o usuário o desabilitar em Mmsys.cpl, o fluxo continuará a ser reproduzido ininterruptamente.

Por outro lado, desabilitar um dispositivo em Gerenciador de Dispositivos remove efetivamente o dispositivo do sistema.

Para usar Mmsys.cpl para exibir os dispositivos de renderização, abra uma janela do Prompt de Comando e insira o seguinte comando:

controle mmsys.cpl,,0

Para exibir os dispositivos de captura, insira o seguinte comando:

controle mmsys.cpl,,1

Como alternativa, você pode exibir os dispositivos de renderização ou os dispositivos de captura em Mmsys.cpl clicando com o botão direito do mouse no ícone do alto-falante na área de notificação, que está localizada no lado direito da barra de tarefas e selecionando Dispositivos de Reprodução ou Dispositivos de Gravação.

Mmsys.cpl sempre exibe dispositivos de ponto de extremidade que estão no estado DEVICE_STATE_ACTIVE. Além disso, ele pode ser configurado para exibir dispositivos desabilitados e desconectados.

Para exibir dispositivos de ponto de extremidade que estão nos estados DEVICE_STATE_DISABLED e DEVICE_STATE_NOTPRESENT, clique com o botão direito do mouse na janela Mmsys.cpl e selecione a opção Mostrar Dispositivos Desabilitados .

Para exibir dispositivos de ponto de extremidade que estão no estado DEVICE_STATE_UNPLUGGED, clique com o botão direito do mouse na janela Mmsys.cpl e selecione a opção Mostrar Dispositivos Desconectados .

Para exibir apenas os dispositivos de ponto de extremidade que estão no estado DEVICE_STATE_ACTIVE, desmarque as opções Mostrar Dispositivos Desabilitados e Mostrar Dispositivos Desconectados .

Para habilitar ou desabilitar um dispositivo de ponto de extremidade no Mmsys.cpl, clique em Reprodução ou Gravação, dependendo se o dispositivo é um dispositivo de reprodução ou gravação. Em seguida, selecione o dispositivo e clique em Propriedades. Na janela Propriedades , ao lado de Uso do dispositivo, selecione Usar este dispositivo (habilitar) ou Não usar este dispositivo (desabilitar).

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho
Mmdeviceapi.h

Confira também

Principais constantes de áudio

IMMDevice::GetState

IMMDeviceEnumerator Interface

IMMDeviceEnumerator::EnumAudioEndpoints

IMMNotificationClient::OnDeviceStateChanged