Получение имени интерфейса устройства

В Windows Me, Windows 2000 и более поздних версий мультимедийные функции Windows waveInMessage, waveOutMessage, midiInMessage, midiOutMessage и mixerMessage могут получить имя интерфейса устройства. Эти сведения полезны для приложений, которым необходимо идентифицировать устройство за пределами API waveIn, waveOut, midiIn, midiOut или mixer. В одном из этих API достаточно идентификатора устройства.

Диспетчер Plug and Play создает имя интерфейса устройства для уникальной идентификации каждого перечисляемого устройства. Приложение должно рассматривать строку, содержащую имя интерфейса устройства, как непрозрачную. Дополнительные сведения об интерфейсах устройств см. в статье Общие сведения об интерфейсах устройств.

Файл заголовка Mmddk.h определяет две константы сообщений для получения имен интерфейса устройства:

DRV_QUERYDEVICEINTERFACESIZE

DRV_QUERYDEVICEINTERFACE

Первое сообщение получает размер буфера, необходимого для хранения строки, содержащей имя интерфейса устройства, в байтах. Второе сообщение извлекает строку имени в буфере требуемого размера.

Система перехватывает и обрабатывает сообщения DRV_QUERYDEVICEINTERFACESIZE и DRV_QUERYDEVICEINTERFACE, не отправляя сообщения в драйвер устройства.

Первым параметром функции xxxMessage является идентификатор устройства, который вызывающий объект должен привести к соответствующему типу дескриптора: HWAVEIN, HWAVEOUT, HMIDIIN, HMIDIOUT или HMIXER. Дополнительные сведения о функциях xxxMessage см. в разделе Системные перехватываемые сообщения устройств.