[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、Windows 10 の新しいバージョンでは UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDFの概要」を参照してください。
GetCreateParametersEx メソッドは、作成または開かれているファイルに関連付けられているファイル作成パラメーターを取得します。
構文
void GetCreateParametersEx(
[out, optional] ULONG *pOptions,
[out, optional] USHORT *pFileAttributes,
[out, optional] USHORT *pShareAccess,
[out, optional] ACCESS_MASK *pDesiredAccess
);
パラメーター
[out, optional] pOptions
ファイル作成オプションを示すビット フラグを受け取る呼び出し元によって割り当てられた変数へのポインター。 これらのFILE_XXXX名前付きビット フラグは Wdm.h で定義されています。
変数の下位 24 ビットは、ファイルを作成または開くときに適用するオプションを示します。 これらのビットの詳細については、カーネル モード ZwCreateFile 関数の CreateOptions パラメーターの説明を参照してください。
変数の上位 8 ビットは、ファイルが実行する場合、またはまだ存在しない場合に実行するアクションを示します。 これらのビットの詳細については、ZwCreateFile の CreateDisposition パラメーター説明を参照してください。
このパラメーターは省略可能であり、NULL できます。
[out, optional] pFileAttributes
ファイル属性を示すビット フラグを受け取る呼び出し元によって割り当てられた変数へのポインター。 これらのFILE_ATTRIBUTE_XXXX名前付きビット フラグは Wdm.h で定義されています。 これらのビット フラグの詳細については、ZwCreateFile の FileAttributes パラメーター説明を参照してください。
このパラメーターは省略可能であり、NULL できます。
[out, optional] pShareAccess
ファイル共有オプションを示すビット フラグを受け取る呼び出し元によって割り当てられた変数へのポインター。 これらのFILE_SHARE_XXXX名付きビット フラグは Wdm.h で定義されています。 これらのビット フラグの詳細については、ZwCreateFile の ShareAccess パラメーター説明を参照してください。
このパラメーターは省略可能であり、NULL できます。
[out, optional] pDesiredAccess
ファイルへの要求されたアクセスを指定する呼び出し元によって割り当てられた ACCESS_MASK 構造体へのポインター。 このパラメーターの詳細については、ZwCreateFile の DesiredAccess パラメーター参照してください。
このパラメーターは省略可能であり、NULL できます。
戻り値
何一つ
備考
フレームワークがドライバーの IQueueCallbackCreate::OnCreateFile コールバック関数を呼び出すと、ドライバーは IWDFIoRequest::GetCreateParameters メソッドまたは IWDFIoRequest2::GetCreateParametersEx メソッドを呼び出して、ファイルの作成パラメーターを取得できます。
詳細については、「I/O 要求のパラメーターの取得」を参照してください。
例
次のコード例は、IQueueCallbackCreate::OnCreateFile コールバック関数が IWDFIoRequest2 インターフェイスを取得し、GetCreateParametersEx 呼び出す方法を示しています。
VOID
OnCreateFile(
__in IWDFIoQueue* FxQueue,
__in IWDFIoRequest* FxRequest,
__in IWDFFile* FxFile
)
{
ULONG fileOptions;
USHORT fileAttributes,
USHORT shareAccess,
ACCESS_MASK desiredAccess;
...
CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
fxRequest2->GetCreateParametersEx(&fileOptions
&fileAttributes,
&shareAccess,
&desiredAccess);
...
}
必要条件
| 要件 | 価値 |
|---|---|
| サポート終了 | UMDF 2.0 以降では使用できません。 |
| ターゲット プラットフォーム の | デスクトップ |
| UMDF の最小バージョン を する | 1.9 |
| ヘッダー | wudfddi.h (Wudfddi.h を含む) |
| DLL | WUDFx.dll |
関連項目
IQueueCallbackCreate::OnCreateFile
IWDFIoRequest2 の