WdfUsbInterfaceGetEndpointInformation 函数 (wdfusb.h)

  • 项目

[适用于 KMDF 和 UMDF]

WdfUsbInterfaceGetEndpointInformation 方法检索有关指定 USB 设备终结点及其关联管道的信息。

语法

void WdfUsbInterfaceGetEndpointInformation(
  [in]      WDFUSBINTERFACE           UsbInterface,
  [in]      UCHAR                     SettingIndex,
  [in]      UCHAR                     EndpointIndex,
  [in, out] PWDF_USB_PIPE_INFORMATION EndpointInfo
);

参数

[in] UsbInterface

通过调用 WdfUsbTargetDeviceGetInterface 获取的 USB 接口对象的句柄。

[in] SettingIndex

标识接口的备用设置的索引值。 有关备用设置的详细信息，请参阅 USB 规范。

[in] EndpointIndex

一个索引值，该值标识与指定接口的指定备用设置关联的终结点。 (此索引值不是终结点地址。)

[in, out] EndpointInfo

指向框架填充的调用方分配 WDF_USB_PIPE_INFORMATION 结构的指针。

返回值

无

备注

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

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

示例

下面的代码示例获取 USB 接口支持的终结点数，然后为每个终结点调用 WdfUsbInterfaceGetEndpointInformation 。

WDF_USB_PIPE_INFORMATION endPointInfo;
BYTE settingIndex, i;

settingIndex = 0;
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
                                          UsbInterface,
                                          settingIndex
                                          );

for (i = 0; i < numEndpoints; i++){
    WDF_USB_PIPE_INFORMATION_INIT(&endPointInfo);
    WdfUsbInterfaceGetEndpointInformation(
                                          UsbInterface,
                                          settingIndex,
                                          i,
                                          &endPointInfo
                                          );

    //
    // Examine endpoint information here.
    //
...
}

要求

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

另请参阅

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetNumEndpoints

WdfUsbTargetDeviceGetInterface