функция DRV_QUERYDEVICEINTERFACE

Статья
02/07/2024

DRV_QUERYDEVICEINTERFACE сообщения запрашивает имя интерфейса устройства waveIn, waveOut, midiIn, midiOut или mixer .

Синтаксис

DWORD  xxxMessage(
   UINT      uDeviceID,
   UINT      uMsg,
   DWORD_PTR dwParam1,
   DWORD_PTR dwParam2
);

Параметры

uDeviceID
Указывает идентификатор целевого устройства.
uMsg
Вызывающий объект задает этому параметру значение DRV_QUERYDEVICEINTERFACE при вызове xxxMessage для обработки сообщения устройства.
dwParam1
Указатель на буфер, выделенный вызывающим объектом, в который функция записывает строку Юникода, завершающуюся null, содержащую имя интерфейса устройства. Если у устройства нет интерфейса устройства, длина строки равна нулю.
dwParam2
Задает размер буфера в байтах. Это входной параметр функции. Вызывающий объект должен указать размер, который больше или равен размеру буфера, полученному DRV_QUERYDEVICEINTERFACESIZE сообщением.

Возвращаемое значение

Функция xxxMessage возвращает MMSYSERR_NOERROR, если сообщение успешно обработано. В противном случае возвращается соответствующий код ошибки.

Сообщение DRV_QUERYDEVICEINTERFACE поддерживается в Windows Me, Windows 2000 и более поздних версий. Это сообщение допустимо только для функций waveInMessage, waveOutMessage, midiInMessage, midiOutMessage и mixerMessage . Система перехватывает это сообщение и возвращает соответствующее значение, не отправляя сообщение драйверу устройства. Общие сведения о функциях xxxMessage , перехваченных системой, см. в разделе System-Intercepted Device Messages.

Следующие две константы сообщений используются вместе для получения имен интерфейса устройства:

DRV_QUERYDEVICEINTERFACESIZE
DRV_QUERYDEVICEINTERFACE

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

Дополнительные сведения см. в разделе Получение имени интерфейса устройства.