функция WinUsb_QueryDeviceInformation (winusb.h)

Статья
08/27/2023

Функция WinUsb_QueryDeviceInformation получает сведения о физическом устройстве, связанном с дескриптором интерфейса WinUSB.

Синтаксис

BOOL WinUsb_QueryDeviceInformation(
  [in]      WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in]      ULONG                   InformationType,
  [in, out] PULONG                  BufferLength,
  [out]     PVOID                   Buffer
);

Параметры

[in] InterfaceHandle

Непрозрачный дескриптор первого интерфейса на устройстве, который возвращается WinUsb_Initialize.

[in] InformationType

Значение типа , указывающее, какое значение сведений об интерфейсе следует извлечь.

На входных данных Параметр InformationType должен иметь следующее значение: DEVICE_SPEED (0x01).

[in, out] BufferLength

Максимальное число байтов, предназначенных для чтения. Это число должно быть меньше или равно размеру буфера в байтах. В выходных данных параметру BufferLength присваивается фактическое количество байтов, скопированных в буфер.

[out] Buffer

Буфер, выделенный вызывающим объектом, который получает запрошенное значение.

Если параметр InformationType DEVICE_SPEED, при успешном возвращении buffer указывает скорость работы устройства. 0x03 указывает на высокую или более высокую скорость; 0x01 указывает на полную или меньшую скорость.

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

WinUsb_QueryDeviceInformation возвращает значение TRUE , если операция выполнена успешно. В противном случае эта подпрограмма возвращает значение FALSE, и вызывающий объект может получить зарегистрированную ошибку, вызвав Метод GetLastError.

GetLastError может вернуть следующий код ошибки.

Код возврата	Описание
ERROR_INVALID_HANDLE	Вызывающий объект передал значение NULL в параметре InterfaceHandle .

Требования


Целевая платформа	Универсальное
Верхняя часть	winusb.h (включая Winusb.h)
Библиотека	Winusb.lib
DLL	Winusb.dll

См. также раздел

WinUSB

Функции WinUSB

WinUsb_Initialize

Поделиться через