функция DRV_QUERYDEVICEINTERFACESIZE

Статья
06/15/2023

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

Синтаксис

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

Параметры

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

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

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

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

Размер буфера, полученный этим сообщением, выражается в виде количества байтов. Он указывает размер буфера, необходимого для хранения строки Юникода, завершаемой null, которая содержит имя интерфейса устройства. Вызывающий объект выделяет буфер указанного размера и использует DRV_QUERYDEVICEINTERFACE сообщение для получения строки имени интерфейса устройства.

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

Требования

Целевая платформа	Персональный компьютер
Версия	Поддерживается в Операционных системах Microsoft Windows Me и Windows 2000 и более поздних версий.
Заголовок	Mmddk.h (включая Mmddk.h)