IWDFIoRequest::GetCreateParameters メソッド (wudfddi.h)

[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、新しいバージョンのWindows 10では UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは UMDF 2 を使用する必要があります。 詳細については、「UMDF を使用したはじめに」を参照してください。

GetCreateParameters メソッドは、作成型要求の要求パラメーターを取得します。

構文

void GetCreateParameters(
  [out, optional] ULONG  *pOptions,
  [out, optional] USHORT *pFileAttributes,
  [out, optional] USHORT *pShareAccess
);

パラメーター

[out, optional] pOptions

要求に関連付けられているファイルを作成または開くときに適用されるオプションと、ファイルが既に存在する場合に実行されるアクションを指定するフラグのビットマスクを受け取る変数へのポインター。

このパラメーターの上位 8 ビットは、カーネル モードの ZwCreateFile 関数の CreateDisposition パラメーターに対応しています。 これらの 8 ビットは、ファイルが既に存在するかどうかに応じて、実行するアクションを指定します。 これらの処理値は、Win32 CreateFile 関数の dwCreationDisposition パラメーターで使用される値とは異なります。

このパラメーターの下位 24 ビットは、ZwCreateFile の CreateOptions パラメーターに対応しています。

このパラメーターは省略可能です。 ドライバーが情報を必要としない場合、ドライバーは NULL を 渡すことができます。

[out, optional] pFileAttributes

要求に関連付けられているファイルを作成または開くときに適用される属性フラグのビットマスクを受け取る変数へのポインター。 明示的に指定された属性は、ファイルが作成、置き換えられる、または場合によっては上書きされた場合にのみ適用されます。 既定では、単一のFILE_ATTRIBUTE_NORMAL フラグが指定されます。 ただし、このフラグは、他のフラグまたは互換性のあるフラグのビットごとの OR 組み合わせによってオーバーライドできます。 属性フラグのビットマスクは、ZwCreateFile の FileAttributes パラメーターに対応します。

このパラメーターは省略可能です。 ドライバーが情報を必要としない場合、ドライバーは NULL を 渡すことができます。

[out, optional] pShareAccess

要求に関連付けられているファイルに対して要求される共有アクセス権を指定するフラグのビットマスクを受け取る変数へのポインター。 受信したビットマスクが 0 の場合、排他アクセスが要求されます。 共有アクセスの詳細については、ZwCreateFile の ShareAccess パラメーターの説明を参照してください。

このパラメーターは省略可能です。 ドライバーが情報を必要としない場合、ドライバーは NULL を 渡すことができます。

戻り値

なし

解説

ドライバーは必要に応じて、pOptions、pFileAttributes、および pShareAccess の各パラメーターに NULL を指定できますが、GetCreateParameters を正常に実行するには、少なくとも 1 つの NULL 以外のパラメーターを指定する必要があります。

要件

こちらもご覧ください

IWDFIoRequest

ZwCreateFile