função DRV_QUERYDEVICEINTERFACE

Artigo
02/03/2024

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.