一般的な I/O ターゲットの初期化
フレームワークは、ドライバーが WdfDeviceCreate呼び出すときに、デバイスのドライバーのローカル I/O ターゲットを初期化します。 デバイスのローカル I/O ターゲットへのハンドルを取得するには、ドライバーは WdfDeviceGetIoTargetを呼び出します。
ほとんどのドライバーは、ローカル I/O ターゲットにのみ要求を送信します。
デバイスのリモート I/O ターゲットを初期化するには、ドライバーは次の操作を行う必要があります。
ドライバーが要求を送信できるようにするため、WdfIoTargetOpen を呼び出して I/O ターゲットを開きます。
ドライバーが WdfIoTargetOpen呼び出すと、通常、オブジェクト名を表す Unicode 文字列を指定することによってリモート I/O ターゲット識別されます。 この名前は、デバイス、ファイル、またはデバイス インターフェイスを識別できます。 フレームワークは、オブジェクト名をサポートするドライバー スタックの先頭に I/O 要求を送信します。
まれに、ドライバーが Windows ドライバー モデル (WDM) DEVICE_OBJECT 構造体へのポインターを指定することによって、リモート I/O ターゲットを識別することがあります。 このポインターは、呼び出し元のドライバーのスタック内の別のドライバーを識別します。 フレームワーク ベースのドライバーは、他のドライバーの DEVICE_OBJECT 構造にアクセスすることはほとんどないため、この手法を使用することはほとんどありません。
次の例は、Ndisedge サンプル ドライバーが上記の手法を使用してリモート I/O ターゲットを作成して開く方法を示しています。
status = WdfIoTargetCreate(Adapter->WdfDevice,
WDF_NO_OBJECT_ATTRIBUTES,
&Adapter->IoTarget);
if (!NT_SUCCESS(status)) {
DEBUGP(MP_ERROR, ("WdfIoTargetCreate failed 0x%x\n",
status));
return status;
}
WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME(&openParams,
&fileName,
STANDARD_RIGHTS_ALL
);
status = WdfIoTargetOpen(Adapter->IoTarget,
&openParams);
if (!NT_SUCCESS(status)) {
DEBUGP(MP_ERROR, ("WdfIoTargetOpen failed 0x%x\n", status));
return status;
}