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) |