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_INIT_CREATE_BY_NAME