Compartilhar via

Obtendo um nome de interface do dispositivo

  • Artigo

No Windows Me e no Windows 2000 e posteriores, as funções multimídia do Windows waveInMessage, waveOutMessage, midiInMessage, midiOutMessage e mixerMessage podem recuperar o nome da interface do dispositivo de um dispositivo. Essas informações são úteis para programas de aplicativo que precisam identificar o dispositivo fora da API waveIn, waveOut, midiIn, midiOut ou mixer. Dentro de uma dessas APIs, uma ID de dispositivo é suficiente.

O gerenciador de Plug and Play gera um nome de interface do dispositivo para identificar exclusivamente cada dispositivo que ele enumera. Um aplicativo deve tratar a cadeia de caracteres que contém um nome de interface do dispositivo como opaco. Para obter mais informações sobre interfaces de dispositivo, consulte Introdução às interfaces de dispositivo.

O arquivo de cabeçalho Mmddk.h define duas constantes de mensagem com a finalidade de 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.

O sistema intercepta e manipula as mensagens DRV_QUERYDEVICEINTERFACESIZE e DRV_QUERYDEVICEINTERFACE sem enviar as mensagens para o driver de dispositivo.

O primeiro parâmetro para a função mensagem xxxé a ID do dispositivo, que o chamador deve converter para o tipo de identificador apropriado: HWAVEIN, HWAVEOUT, HMIDIIN, HMIDIOUT ou HMIXER. Para obter mais informações sobre as funções de mensagem xxx, consulte Mensagens de dispositivo interceptadas pelo sistema.