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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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 |
|