ID do dispositivo de Voice-Communications preferencial

No Windows Me e no Windows 2000 e posterior, as funções multimídia do Windows waveInMessage e waveOutMessage podem recuperar a ID do dispositivo preferencial para comunicações de voz. Essas duas funções obtêm as IDs de dispositivo de comunicação de voz preferidas para entrada de onda e saída de onda, respectivamente. Cada ID do dispositivo identifica o dispositivo de onda que é preferencial especificamente para comunicações de voz, em contraste com o dispositivo de onda que é preferencial para o uso geral de áudio de onda. Para obter informações sobre como obter a ID do dispositivo preferencial para áudio de onda geral, consulte Acessando a ID do dispositivo preferencial.

Conhecer o dispositivo de comunicação de voz preferencial pode ser útil para programas de aplicativo que, por exemplo, permitem que os usuários selecionem um dispositivo para abrir em uma lista de dois ou mais dispositivos. Esse aplicativo normalmente precisa indicar qual dos dispositivos na lista é o dispositivo preferencial.

Para recuperar a ID do dispositivo de comunicação de voz preferencial atual, um aplicativo chama a função wave XxxMessage com o parâmetro de mensagem definido como a constante DRVM_MAPPER_CONSOLEVOICECOM_GET.

Ao chamar a função waveInMessage ou waveOutMessage com a mensagem DRVM_MAPPER_CONSOLEVOICECOM_GET, especifique o valor do identificador do dispositivo como WAVE_MAPPER e converta esse valor para o tipo de identificador apropriado, HWAVEIN ou HWAVEOUT. As funções wave XxxMessage aceitam esse valor no lugar de um identificador de dispositivo válido para que um aplicativo possa consultar a ID do dispositivo padrão sem primeiro precisar abrir um dispositivo. Para obter mais informações sobre as funções wave XxxMessage, consulte Mensagens de dispositivo interceptadas pelo sistema.

A mensagem DRVM_MAPPER_PREFERRED_GET é interceptada pelo mapeador do dispositivo de destino (waveIn ou waveOut). Para obter informações sobre mapeadores para dispositivos de onda, consulte a documentação do SDK do Microsoft Windows.