função DRV_QUERYMAPPABLE

Artigo
03/08/2023

O DRV_QUERYMAPPABLE consultas de mensagem para saber se o dispositivo especificado pode ser usado por um mapeador.

Sintaxe

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

Parâmetros

Udeviceid
Especifica a ID do dispositivo de destino.
uMsg
O chamador define esse parâmetro como DRV_QUERYMAPPABLE quando chama xxxMessage para processar essa mensagem de dispositivo.
Dwparam1
Não utilizado. Defina esse parâmetro como zero.
Dwparam2
Não utilizado. Defina esse parâmetro como zero.

Retornar valor

A função xxxMessage retornará MMSYSERR_NOERROR se o dispositivo for mappable. Caso contrário, ele retornará um código de erro apropriado.

Comentários

Essa mensagem é válida apenas para as funções waveInMessage, waveOutMessage, midiInMessage, midiOutMessage, mixerMessage e auxOutMessage . O sistema intercepta essa mensagem e retorna o valor apropriado sem enviar a mensagem para o driver do dispositivo. Para obter informações gerais sobre funções xxxMessage interceptadas pelo sistema, consulte Mensagens de dispositivo interceptadas pelo sistema.

Quando um programa de aplicativo abre um mapeador em vez de um dispositivo de áudio específico, o sistema insere um mapeador entre o aplicativo e os dispositivos disponíveis. O mapeador seleciona um dispositivo apropriado mapeando os requisitos do aplicativo para um dos dispositivos disponíveis. Para obter mais informações sobre mapeados, consulte a documentação do SDK do Microsoft Windows.

Requisitos

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