Метод IWDFUsbTargetDevice::RetrieveDeviceInformation (wudfusb.h)

  • Статья

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]

Метод RetrieveDeviceInformation извлекает сведения об устройстве указанного типа.

Синтаксис

HRESULT RetrieveDeviceInformation(
  [in]      ULONG InformationType,
  [in, out] ULONG *BufferLength,
  [out]     PVOID Buffer
);

Параметры

[in] InformationType

Тип сведений, запрашиваемых драйвером UMDF об устройстве.

[in, out] BufferLength

Указатель на переменную, которая на входных данных содержит размер буфера, который RetrieveDeviceInformation предоставляет в буфере (в байтах). В выходных данных этот параметр содержит размер, необходимый RetrieveDeviceInformation для буфера.

[out] Buffer

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

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

RetrieveDeviceInformation возвращает одно из следующих значений:

Код возврата Описание
S_OK

RetrieveDeviceInformation успешно извлек сведения об устройстве.
E_OUTOFMEMORY

RetrieveDeviceInformation столкнулся с ошибкой выделения.
Код ошибки, определенный в Winerror.h
 Это значение соответствует коду ошибки, возвращенной API WinUsb.

Комментарии

Сведения о допустимых типах сведений, которые драйвер UMDF может передать для параметра InformationType , см. в функции WinUsb_QueryDeviceInformation .

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

Метод RetrieveDeviceInformation создает запрос UMDF и синхронно отправляет запрос в целевой объект ввода-вывода.

Примеры

Пример кода использования методаRetrieveDeviceInformation см. в разделе IWDFUsbTargetPipe::SetPipePolicy.

Требования

Требование Значение
Дата окончания поддержки Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Минимальная версия UMDF 1.5
Верхняя часть wudfusb.h (включая Wudfusb.h)
DLL WUDFx.dll

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

IWDFUsbTargetDevice

WinUsb_QueryDeviceInformation