função DRV_QUERYDEVICEINTERFACESIZE

Artigo
03/08/2023

O DRV_QUERYDEVICEINTERFACESIZE consultas de mensagem para o tamanho do buffer necessário para manter o nome da interface do dispositivo.

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_QUERYDEVICEINTERFACESIZE quando chama xxxMessage para processar essa mensagem de dispositivo.
Dwparam1
Ponteiro para o tamanho do buffer. Esse parâmetro aponta para uma variável ULONG na qual a função grava o tamanho do buffer necessário em bytes. O tamanho inclui espaço de armazenamento para o nulo de terminação da cadeia de caracteres de nome. O tamanho será zero se a ID do dispositivo identificar um dispositivo que não tenha interface do dispositivo.
Dwparam2
Não utilizado. Defina esse parâmetro como zero.

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

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 de dispositivo. Para obter informações gerais sobre funções xxxMessage interceptadas pelo sistema, consulte Mensagens de dispositivo interceptadas pelo sistema.

O tamanho do buffer recuperado por essa mensagem é expresso como uma contagem de bytes. Ele especifica o tamanho do buffer necessário para manter a cadeia de caracteres Unicode terminada em nulo que contém o nome da interface do dispositivo. O chamador aloca um buffer do tamanho especificado e usa a mensagem DRV_QUERYDEVICEINTERFACE para recuperar a cadeia de caracteres de nome da interface do dispositivo.

Para obter mais informações, consulte Obtendo um nome de interface do dispositivo.

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)