Acessando a ID do dispositivo preferencial

As funções multimídia do Windows waveInMessage, waveOutMessage e midiOutMessage podem recuperar a ID do dispositivo preferencial. Essas três funções obtêm as IDs de dispositivo preferenciais para entrada de onda, saída de onda e saída MIDI, respectivamente. Essas informações são úteis 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.

O dispositivo preferencial é o dispositivo que o usuário seleciona por meio do painel de controle multimídia, mmsys.cpl. Se um aplicativo multimídia ou DirectSound do Windows não especificar explicitamente um dispositivo, o dispositivo preferencial será selecionado por padrão.

Para recuperar a ID do dispositivo de áudio preferencial atual, um aplicativo chama a função xxxMessage com o parâmetro message definido como a constante DRVM_MAPPER_PREFERRED_GET.

Ao chamar a função waveInMessage, waveOutMessage ou midiOutMessage com a mensagem DRVM_MAPPER_PREFERRED_GET, especifique o valor do identificador do dispositivo como WAVE_MAPPER (para waveInMessage ou waveOutMessage) ou MIDI_MAPPER (para midiOutMessage) e converta esse valor para o tipo de identificador apropriado: HWAVEIN, HWAVEOUT ou HMIDIOUT. As funções 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 de mensagemxxx, consulte Mensagens de dispositivo interceptadas pelo sistema.

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