WdfUsbTargetPipeGetIoTarget 関数 (wdfusb.h)
[KMDF と UMDF に適用]
WdfUsbTargetPipeGetIoTarget メソッドは、指定された USB パイプに関連付けられている I/O ターゲット オブジェクトへのハンドルを返します。
構文
WDFIOTARGET WdfUsbTargetPipeGetIoTarget(
[in] WDFUSBPIPE Pipe
);
パラメーター
[in] Pipe
WdfUsbInterfaceGetConfiguredPipe を呼び出して取得されたフレームワーク パイプ オブジェクトへのハンドル。
戻り値
WdfUsbTargetPipeGetIoTarget は、指定されたパイプ オブジェクトに関連付けられている I/O ターゲット オブジェクトへのハンドルを返します。
ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。
注釈
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 |
| Header | wdfusb.h (Wdfusb.h を含む) |
| Library | Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF) |
| IRQL | 任意のレベル |
| DDI コンプライアンス規則 | DriverCreate(kmdf), FailD0EntryIoTargetState(kmdf) |