WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE関数 (wdfiotarget.h)

[UMDF にのみ適用]

WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE関数は、ドライバーがファイル名を指定して I/O ターゲットを開くことができるように、ドライバーのWDF_IO_TARGET_OPEN_PARAMS構造体を初期化します。

構文

void WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE(
  [out]          PWDF_IO_TARGET_OPEN_PARAMS Params,
  [in, optional] PCUNICODE_STRING           FileName
);

パラメーター

[out] Params

ドライバーによって割り当てられた WDF_IO_TARGET_OPEN_PARAMS 構造体へのポインター。この構造体は、関数によって初期化されます。

[in, optional] FileName

WDF_IO_TARGET_OPEN_PARAMS構造体の FileName メンバーの値。 低いターゲットがデバイス名前空間アクセスをサポートしていない限り、ほとんどのドライバーはここで NULL を指定します。

戻り値

なし

解説

WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE関数は、指定したWDF_IO_TARGET_OPEN_PARAMS構造体をゼロにし、その Size メンバーを設定します。 また、構造体の Type メンバーを WdfIoTargetOpenLocalTargetByFile に設定し、ドライバーがファイル名を指定する場合は FileName メンバーを設定します。

ドライバーは 、WdfIoTargetClose を呼び出すことによって、I/O ターゲットを明示的に閉じることができます。 ドライバーがターゲットを明示的に閉じない場合、フレームワークはデバイスが削除されたときにターゲットを自動的に閉じます (I/O ターゲットは既定でデバイスに親されます)。

例

次のコード例は、「WDF_IO_TARGET_OPEN_TYPE」で説明されているように、UMDF ドライバーがファイル オブジェクトを使用してローカル ターゲットを開く方法 を示しています。

WDF_OBJECT_ATTRIBUTES  ioTargetAttrib;
WDFIOTARGET  ioTarget;
WDF_IO_TARGET_OPEN_PARAMS  openParams;

//
// Create target
//
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&ioTargetAttrib, TARGET_DEVICE_INFO);
status = WdfIoTargetCreate(device, &ioTargetAttrib, &ioTarget);
if (!NT_SUCCESS(status)) {
    return status;
}

//
// Open target
//
WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE(&openParams, NULL);
status = WdfIoTargetOpen(ioTarget, &openParams);
if (!NT_SUCCESS(status)) {
    WdfObjectDelete(ioTarget);
    return status;
}

//
// create a request
//


//
// Format the request for the above target
//


//
// Send request to above target
//

要件

要件	値
サポートされている最小のクライアント	Windows 8.1
対象プラットフォーム	ユニバーサル
最小 UMDF バージョン	2.0
Header	wdfiotarget.h (Wdf.h を含む)
IRQL	任意のレベル

こちらもご覧ください

WDF_IO_TARGET_OPEN_PARAMS

WDF_IO_TARGET_OPEN_TYPE