IWDFIoRequest::GetCreateParameters メソッド (wudfddi.h)
[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、Windows 10 の新しいバージョンでは UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDFの概要」を参照してください。
GetCreateParameters メソッドは、create-type 要求の要求パラメーターを取得します。
構文
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 パラメーターを指定する必要があります。
必要条件
要件 | 価値 |
---|---|
サポート終了 | UMDF 2.0 以降では使用できません。 |
ターゲット プラットフォーム の | デスクトップ |
UMDF の最小バージョン を する | 1.5 |
ヘッダー | wudfddi.h (Wudfddi.h を含む) |
DLL | WUDFx.dll |
関連項目
IWDFIoRequest の