Função DRVM_MAPPER_PREFERRED_GET

Artigo
02/03/2024

A mensagem DRVM_MAPPER_PREFERRED_GET recupera a ID do dispositivo de áudio preferencial.

Sintaxe

DWORD  xxxMessage(
   UINT      uDeviceID,
   UINT      uMsg,
   DWORD_PTR dwParam1,
   DWORD_PTR dwParam2
);

Parâmetros

Udeviceid
Especifica a ID do dispositivo de destino. Consulte a seção Comentários a seguir para obter mais informações sobre como converter esse valor para uso com a função apropriada.
uMsg
O chamador define esse parâmetro como DRVM_MAPPER_PREFERRED_GET quando chama xxxMessage para processar essa mensagem do dispositivo.
Dwparam1
Ponteiro para a ID do dispositivo. Esse parâmetro aponta para uma variável DWORD na qual a função grava a ID do dispositivo preferencial atual. A função gravará o valor (-1) se nenhum dispositivo estiver disponível que se qualifique como um dispositivo preferencial.
Dwparam2
Ponteiro para status sinalizadores. Esse parâmetro aponta para uma variável DWORD na qual a função grava os sinalizadores status dispositivo. Apenas um bit de sinalizador está definido no momento (somente para chamadas waveInMessage e waveOutMessage ): DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY. Para obter mais informações, consulte a seção Comentários a seguir.

Retornar valor

A função mensagem xxxretornará MMSYSERR_NOERROR se a mensagem for tratada com êxito. Caso contrário, ele retornará um código de erro apropriado.

Comentários

Essa mensagem é válida apenas para as funções waveInMessage, waveOutMessage e midiOutMessage . Quando o chamador chama essas funções com a mensagem DRVM_MAPPER_PREFERRED_GET, o chamador deve primeiro especificar a ID do dispositivo como WAVE_MAPPER (para waveInMessage ou waveOutMessage) ou MIDI_MAPPER (para midiOutMessage) e, em seguida, converter esse valor para o tipo de identificador apropriado. Para as funções waveInMessage, waveOutMessage ou midiOutMessage , o chamador deve converter a ID do dispositivo em um tipo de identificador HWAVEIN, HWAVEOUT ou HMIDIOUT, respectivamente. Observe que, se o chamador fornecer um identificador válido em vez de uma ID de dispositivo para esse parâmetro, a função falhará e retornará o código de erro MMSYSERR_NOSUPPORT.

O sistema intercepta essa mensagem e retorna o valor apropriado sem enviar a mensagem para o driver de dispositivo. Para obter informações gerais sobre funções xxxMessage interceptadas pelo sistema, consulte Mensagens de dispositivo interceptadas pelo sistema.

Essa mensagem fornece uma maneira de determinar qual dispositivo é preferencial para funções de áudio em geral, em contraste com a mensagem DRVM_MAPPER_CONSOLEVOICECOM_GET , que determina qual dispositivo é preferencial especificamente para comunicações de voz.

Quando o bit do sinalizador DRVM_MAPPER_PREFERRED_FLAGS_PREFERREDONLY é definido no local DWORD apontado por dwParam2, as APIs waveIn e waveOut usam apenas o dispositivo preferencial atual e não pesquisam outros dispositivos disponíveis se o dispositivo preferencial não estiver disponível. Observe que a função midiOutMessage não gera esse sinalizador – a API midiOut sempre usa apenas o dispositivo preferencial. O sinalizador que é gerado pela chamada waveInMessage ou waveOutMessage aplica-se ao dispositivo preferencial para as APIs waveIn e waveOut , independentemente de a chamada ser feita para waveInMessage ou waveOutMessage.

As funções xxxMessage aceitam esse valor no lugar de um identificador de dispositivo válido para permitir que um aplicativo determine a ID do dispositivo padrão sem primeiro precisar abrir um dispositivo. Para obter mais informações, consulte Acessando a ID do dispositivo preferencial.

Requisitos

Plataforma de destino	Área de Trabalho
Versão	Com suporte nos sistemas operacionais Microsoft Windows Me e Windows 2000 e posterior.
parâmetro	Mmddk.h (inclua Mmddk.h)