função DRV_QUERYDEVICEINTERFACESIZE
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) |
Confira também
Obtendo um nome de interface do dispositivo