WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME関数 (wdfiotarget.h)

[KMDF と UMDF に適用]

WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME関数は、ドライバーのWDF_IO_TARGET_OPEN_PARAMS構造体を初期化して、ドライバーがデバイス、ファイル、またはデバイス インターフェイスの名前を指定して I/O ターゲットを開くことができるようにします。 指定された名前が存在しない場合、システムは名前の作成を試みません。

構文

void WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME(
  [out] PWDF_IO_TARGET_OPEN_PARAMS Params,
  [in]  PCUNICODE_STRING           TargetDeviceName,
  [in]  ACCESS_MASK                DesiredAccess
);

パラメーター

[out] Params

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

[in] TargetDeviceName

WDF_IO_TARGET_OPEN_PARAMS構造体の TargetDeviceName メンバーの値。

[in] DesiredAccess

WDF_IO_TARGET_OPEN_PARAMS構造体の DesiredAccess メンバーの値。

戻り値

なし

解説

TargetDeviceName で既に存在するファイルの名前が指定されている場合、システムは既存のファイルを開きます。 ファイルが存在しない場合、開いている操作は失敗します。

WDF_IO_TARGET_OPEN_PARAMS構造体は、WdfIoTargetOpen メソッドへの入力として使用されます。

WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME関数は、指定したWDF_IO_TARGET_OPEN_PARAMS構造体の Size、Type、TargetDeviceName、DesiredAccess、CreateOptions、CreateDisposition の各メンバーを初期化します。

Kmdf WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME関数は、CreateDisposition メンバーを初期化してFILE_OPENします。

Umdf WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME関数は、CreateDisposition メンバーを初期化してOPEN_EXISTINGします。

I/O ターゲットの詳細については、「 I/O ターゲットの使用」を参照してください。

例

WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAMEを使用するコード例については、「WdfIoTargetOpen」を参照してください。

要件

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
最小 UMDF バージョン	2.0
Header	wdfiotarget.h (Wdf.h を含む)
IRQL	任意のレベル

こちらもご覧ください

WDF_IO_TARGET_OPEN_PARAMS

WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME

WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE

WdfIoTargetOpen