WdfUsbTargetDeviceGetDeviceDescriptor 函数 (wdfusb.h)

  • 项目

[适用于 KMDF 和 UMDF]

WdfUsbTargetDeviceGetDeviceDescriptor 方法检索与指定框架 USB 设备对象关联的 USB 设备描述符。

语法

void WdfUsbTargetDeviceGetDeviceDescriptor(
  [in]  WDFUSBDEVICE           UsbDevice,
  [out] PUSB_DEVICE_DESCRIPTOR UsbDeviceDescriptor
);

参数

[in] UsbDevice

USB 设备对象的句柄，该对象是从之前调用 WdfUsbTargetDeviceCreateWithParameters 获取的。

[out] UsbDeviceDescriptor

指向调用方分配 的USB_DEVICE_DESCRIPTOR 结构的指针，该结构接收 USB 设备描述符。

返回值

无

备注

如果驱动程序提供的对象句柄无效，则会发生 bug 检查。

有关 WdfUsbTargetDeviceGetDeviceDescriptor 方法和 USB I/O 目标的详细信息，请参阅 USB I/O 目标。

示例

下面的代码示例获取设备的 USB 设备描述符。 该示例将描述符存储在驱动程序定义的上下文空间中。

PMY_DEVICE_CONTEXT  myDeviceContext;

myDeviceContext = GetDeviceContext(device);

WdfUsbTargetDeviceGetDeviceDescriptor(
                                      myDeviceContext->UsbTargetDevice,
                                      &myDeviceContext->UsbDeviceDescr
                                      );

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfusb.h (包括 Wdfusb.h)
Library Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
DDI 符合性规则 DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) ， UsbKmdfIrql (kmdf) 、 UsbKmdfIrql2 (kmdf) 、 UsbKmdfIrqlExplicit (kmdf)

另请参阅

USB_DEVICE_DESCRIPTOR

WdfUsbTargetDeviceCreateWithParameters