WdfUsbTargetPipeGetIoTarget 函数 (wdfusb.h)
[适用于 KMDF 和 UMDF]
WdfUsbTargetPipeGetIoTarget 方法返回与指定 USB 管道关联的 I/O 目标对象的句柄。
语法
WDFIOTARGET WdfUsbTargetPipeGetIoTarget(
[in] WDFUSBPIPE Pipe
);
参数
[in] Pipe
通过调用 WdfUsbInterfaceGetConfiguredPipe 获取的框架管道对象的句柄。
返回值
WdfUsbTargetPipeGetIoTarget 返回与指定管道对象关联的 I/O 目标对象的句柄。
如果驱动程序提供无效的对象句柄，则会发生 bug 检查。
注解
有关 WdfUsbTargetPipeGetIoTarget 方法和 USB I/O 目标的详细信息，请参阅 USB I/O 目标。
示例
下面的代码示例演示 EvtDeviceD0Entry 回调函数如何启动 USB 管道的连续读取器。
NTSTATUS
MyEvtDeviceD0Entry(
IN WDFDEVICE Device,
IN WDF_POWER_DEVICE_STATE PreviousState
)
{
PDEVICE_CONTEXT pDeviceContext;
NTSTATUS status;
pDeviceContext = GetMyDeviceContext(Device);
status = WdfIoTargetStart(WdfUsbTargetPipeGetIoTarget(pDeviceContext->InterruptPipe));
return status;
}
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 通用 |
| 最低 KMDF 版本 | 1.0 |
| 最低 UMDF 版本 | 2.0 |
| 标头 | wdfusb.h (包括 Wdfusb.h) |
| Library | Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF) |
| IRQL | 任何级别 |
| DDI 符合性规则 | DriverCreate (kmdf) ， FailD0EntryIoTargetState (kmdf) |