IWDFUsbTargetDevice：：RetrieveDeviceInformation 方法 (wudfusb.h)

  • 项目

[警告： UMDF 2 是最新版本的 UMDF，取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 未向 UMDF 1 添加新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅使用 UMDF 入门。]

RetrieveDeviceInformation 方法检索指定类型的设备信息。

语法

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

参数

[in] InformationType

UMDF 驱动程序请求的有关设备的信息的类型。

[in, out] BufferLength

指向变量的指针，该变量在输入时包含 RetrieveDeviceInformation 在 Buffer 中提供的缓冲区的大小（以字节为单位）。 输出时，此参数包含 Buffer 的 RetrieveDeviceInformation 所需的大小。

[out] Buffer

接收包含设备信息的缓冲区的指针。

返回值

RetrieveDeviceInformation 返回以下值之一：

返回代码 说明
S_OK

RetrieveDeviceInformation 已成功检索设备信息。
E_OUTOFMEMORY

RetrieveDeviceInformation 遇到分配失败。
Winerror.h 中定义的错误代码
 此值对应于 WinUsb API 返回的错误代码。

注解

有关 UMDF 驱动程序可为 InformationType 参数传递的有效信息类型的信息，请参阅 WinUsb_QueryDeviceInformation 函数。

如果 InformationType DEVICE_SPEED (0x01) 成功返回时， Buffer 指示设备的运行速度。 0x03表示高速或更高;0x01表示全速或更低。

RetrieveDeviceInformation 方法生成 UMDF 请求，并将请求同步发送到 I/O 目标。

示例

有关如何使用RetrieveDeviceInformation 方法的代码示例，请参阅 IWDFUsbTargetPipe：：SetPipePolicy。

要求

要求 值
结束支持 在 UMDF 2.0 及更高版本中不可用。
目标平台 桌面
最低 UMDF 版本 1.5
标头 wudfusb.h (包括 Wudfusb.h)
DLL WUDFx.dll

另请参阅

IWDFUsbTargetDevice

WinUsb_QueryDeviceInformation