função DRV_QUERYDEVICEINTERFACE
O DRV_QUERYDEVICEINTERFACE consultas de mensagem para o nome da interface do dispositivo de um waveIn, waveOut, midiIn, midiOut ou dispositivo de mixer .
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_QUERYDEVICEINTERFACE quando chama xxxMessage para processar essa mensagem de dispositivo.Dwparam1
Ponteiro para um buffer alocado pelo chamador no qual a função grava uma cadeia de caracteres Unicode terminada em nulo que contém o nome da interface do dispositivo. Se o dispositivo não tiver interface do dispositivo, o comprimento da cadeia de caracteres será zero.Dwparam2
Especifica o tamanho do buffer em bytes. Esse é um parâmetro de entrada para a função . O chamador deve especificar um tamanho maior ou igual ao tamanho do buffer recuperado pela mensagem DRV_QUERYDEVICEINTERFACESIZE .
Retornar valor
A função xxxMessage retornará MMSYSERR_NOERROR se a mensagem for tratada com êxito. Caso contrário, ele retornará um código de erro apropriado.
Comentários
A mensagem DRV_QUERYDEVICEINTERFACE tem suporte no Windows Me e no Windows 2000 e posterior. Essa mensagem é válida apenas para as funções waveInMessage, waveOutMessage, midiInMessage, midiOutMessage e mixerMessage . 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.
As duas constantes de mensagem a seguir são usadas juntas para obter nomes de interface do dispositivo:
DRV_QUERYDEVICEINTERFACESIZE
DRV_QUERYDEVICEINTERFACE
A primeira mensagem obtém o tamanho em bytes do buffer necessário para manter a cadeia de caracteres que contém o nome da interface do dispositivo. A segunda mensagem recupera a cadeia de caracteres de nome em um buffer do tamanho necessário.
Para obter mais informações, consulte Obtendo um nome de interface do dispositivo.
Requisitos
Plataforma de destino |
Área de Trabalho |
parâmetro |
Mmddk.h (inclua Mmddk.h) |