ZwCreateFile 関数 (wdm.h)
ZwCreateFile ルーチンは、新しいファイルを作成するか、既存のファイルを開きます。
構文
NTSYSAPI NTSTATUS ZwCreateFile(
[out] PHANDLE FileHandle,
[in] ACCESS_MASK DesiredAccess,
[in] POBJECT_ATTRIBUTES ObjectAttributes,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[in, optional] PLARGE_INTEGER AllocationSize,
[in] ULONG FileAttributes,
[in] ULONG ShareAccess,
[in] ULONG CreateDisposition,
[in] ULONG CreateOptions,
[in, optional] PVOID EaBuffer,
[in] ULONG EaLength
);
パラメーター
[out] FileHandle
ファイルへのハンドルを受け取る HANDLE 変数へのポインター。
[in] DesiredAccess
オブジェクトへの要求されたアクセスを決定する ACCESS_MASK 値を指定します。 呼び出し元は、すべての種類のオブジェクトに対して定義されているアクセス権に加えて、ファイルに固有の次のいずれかのアクセス権を指定できます。
| ACCESS_MASK フラグ | 呼び出し元がこれを行うことを許可します |
|---|---|
| FILE_READ_DATA | ファイルからデータを読み取ります。 |
| FILE_READ_ATTRIBUTES | ファイルの属性を読み取ります。 (詳細については、 FileAttributes パラメーターの説明を参照してください)。 |
| FILE_READ_EA | ファイルの拡張属性 (EA) を読み取ります。 このフラグは、デバイスドライバーと中間ドライバーには関係ありません。 |
| FILE_WRITE_DATA | ファイルにデータを書き込みます。 |
| FILE_WRITE_ATTRIBUTES | ファイルの属性を書き込みます。 (詳細については、 FileAttributes パラメーターの説明を参照してください)。 |
| FILE_WRITE_EA | ファイルの拡張属性 (EA) を変更します。 このフラグは、デバイスドライバーと中間ドライバーには関係ありません。 |
| FILE_APPEND_DATA | ファイルにデータを追加します。 |
| FILE_EXECUTE | システム ページング I/O を使用して、ファイルからメモリにデータを読み取ります。 このフラグは、デバイスドライバーと中間ドライバーには関係ありません。 |
ディレクトリを作成または開くときに、FILE_READ_DATA、FILE_WRITE_DATA、FILE_APPEND_DATA、またはFILE_EXECUTEを指定しないでください。
呼び出し元は、ディレクトリではなく、ファイルに対してのみ汎用アクセス権 (GENERIC_XXX) を指定できます。 汎用アクセス権は、次の表に示すように、特定のアクセス権に対応します。
| 汎用アクセス権 | 特定のアクセス権のセット |
|---|---|
| GENERIC_READ | STANDARD_RIGHTS_READ、FILE_READ_DATA、FILE_READ_ATTRIBUTES、FILE_READ_EA、SYNCHRONIZE。 |
| GENERIC_WRITE | STANDARD_RIGHTS_WRITE、FILE_WRITE_DATA、FILE_WRITE_ATTRIBUTES、FILE_WRITE_EA、FILE_APPEND_DATA、SYNCHRONIZE。 |
| GENERIC_EXECUTE | STANDARD_RIGHTS_EXECUTE、FILE_EXECUTE、FILE_READ_ATTRIBUTES、SYNCHRONIZE。 この値は、デバイスドライバーと中間ドライバーには関係ありません。 |
| GENERIC_ALL | FILE_ALL_ACCESS。 |
たとえば、ファイル オブジェクトにGENERIC_READを指定した場合、ルーチンはこの値を特定のアクセス権のFILE_GENERIC_READビットマスクにマップします。 前の表では、GENERIC_READに一覧表示されている特定のアクセス権は、FILE_GENERIC_READビットマスクに含まれるアクセス フラグに対応しています。
ファイルが実際にディレクトリである場合、呼び出し元は次の汎用アクセス権を指定することもできます。
| DesiredAccess フラグ | 呼び出し元がこれを行うことを許可します |
|---|---|
| FILE_LIST_DIRECTORY | ディレクトリ内のファイルを一覧表示します。 |
| FILE_TRAVERSE | つまり、ディレクトリを走査し、ファイルのパスに ディレクトリを含めます。 |
アクセス権の詳細については、「 ACCESS_MASK」を参照してください。
[in] ObjectAttributes
オブジェクト名とその他の属性を指定する OBJECT_ATTRIBUTES 構造体へのポインター。 InitializeObjectAttributes を使用して、この構造体を初期化します。 呼び出し元がシステム スレッド コンテキストで実行されていない場合は、 InitializeObjectAttributes を呼び出すときにOBJ_KERNEL_HANDLE属性を設定する必要があります。
[out] IoStatusBlock
最終的 な完了 状態と、要求された操作に関するその他の情報を受け取るIO_STATUS_BLOCK構造体へのポインター。 特に、 Information メンバーは次のいずれかの値を受け取ります。
FILE_CREATED
FILE_OPENED
FILE_OVERWRITTEN
FILE_SUPERSEDED
FILE_EXISTS
FILE_DOES_NOT_EXIST
[in, optional] AllocationSize
作成または上書きされたファイルの初期割り当てサイズ (バイト単位) を含むLARGE_INTEGERへのポインター。 AllocationSize が NULL の場合、割り当てサイズは指定されません。 ファイルが作成または上書きされない場合、 AllocationSize は無視されます。
[in] FileAttributes
ファイルを作成または上書きする場合に設定するファイル属性を表す、1 つ以上のFILE_ATTRIBUTE_XXX フラグを指定します。 呼び出し元は通常、既定の属性を設定するFILE_ATTRIBUTE_NORMALを指定します。 有効なFILE_ATTRIBUTE_XXX フラグの一覧については、 CreateFile ルーチンを参照してください。 ファイルが作成または上書きされない場合、 FileAttributes は無視されます。
[in] ShareAccess
0 または次のフラグの任意の組み合わせとして指定される共有アクセスの種類。
| ShareAccess フラグ | 他のスレッドがこれを行うことを許可します |
|---|---|
| FILE_SHARE_READ | ファイルを読み取る |
| FILE_SHARE_WRITE | ファイルを書き込む |
| FILE_SHARE_DELETE | ファイルを削除する |
通常、デバイスドライバーと中間ドライバーは ShareAccess を 0 に設定します。これにより、呼び出し元は開いているファイルに排他的にアクセスできます。
[in] CreateDisposition
ファイルが存在する場合、または存在しない場合に実行するアクションを指定します。 CreateDisposition には、次の表のいずれかの値を指定できます。
| CreateDisposition 値 | ファイルが存在する場合のアクション | ファイルが存在しない場合のアクション |
|---|---|---|
| FILE_SUPERSEDE | ファイルを置き換えます。 | ファイルを作成します。 |
| FILE_CREATE | エラーを返します。 | ファイルを作成します。 |
| FILE_OPEN | ファイル を開きます。 | エラーを返します。 |
| FILE_OPEN_IF | ファイル を開きます。 | ファイルを作成します。 |
| FILE_OVERWRITE | ファイルを開き、上書きします。 | エラーを返します。 |
| FILE_OVERWRITE_IF | ファイルを開き、上書きします。 | ファイルを作成します。 |
[in] CreateOptions
ドライバーがファイルを作成または開くときに適用するオプションを指定します。 次の表の 1 つ以上のフラグを使用します。
| CreateOptions フラグ | 意味 |
|---|---|
| FILE_DIRECTORY_FILE | ファイルはディレクトリです。 互換性のある CreateOptions フラグは、FILE_SYNCHRONOUS_IO_ALERT、FILE_SYNCHRONOUS_IO_NONALERT、FILE_WRITE_THROUGH、FILE_OPEN_FOR_BACKUP_INTENT、およびFILE_OPEN_BY_FILE_IDです。 CreateDisposition パラメーターは、FILE_CREATE、FILE_OPEN、またはFILE_OPEN_IFに設定する必要があります。 |
| FILE_NON_DIRECTORY_FILE | ファイルがディレクトリではありません。 開くファイル オブジェクトは、データ ファイルを表すことができます。論理デバイス、仮想デバイス、または物理デバイス。またはボリューム。 |
| FILE_WRITE_THROUGH | ファイルにデータを書き込むシステム サービス、ファイル システム ドライバー、ドライバーは、要求された書き込み操作が完了したと見なされる前に、実際にデータをファイルに転送する必要があります。 |
| FILE_SEQUENTIAL_ONLY | ファイルへのすべてのアクセスはシーケンシャルになります。 |
| FILE_RANDOM_ACCESS | ファイルへのアクセスはランダムな場合があるため、ファイル システム ドライバーまたはシステムによって順次先読み操作を実行する必要はありません。 |
| FILE_NO_INTERMEDIATE_BUFFERING | ファイルをキャッシュしたり、ドライバーの内部バッファーにバッファー化したりすることはできません。 このフラグは、 DesiredAccess パラメーターの FILE_APPEND_DATA フラグと互換性がありません。 |
| FILE_SYNCHRONOUS_IO_ALERT | ファイルに対するすべての操作が同期的に実行されます。 呼び出し元に代わって待機すると、アラートが早期に終了する可能性があります。 また、このフラグにより、I/O システムはファイル位置ポインターを維持します。 このフラグが設定されている場合は、 DesiredAccess パラメーターで SYNCHRONIZE フラグを設定する必要があります。 |
| FILE_SYNCHRONOUS_IO_NONALERT | ファイルに対するすべての操作が同期的に実行されます。 I/O キューと完了を同期するシステムでの待機は、アラートの対象になりません。 また、このフラグにより、I/O システムはファイル位置コンテキストを維持します。 このフラグが設定されている場合は、 DesiredAccess パラメーターで SYNCHRONIZE フラグを設定する必要があります。 |
| FILE_CREATE_TREE_CONNECTION | ネットワーク経由で開くために、このファイルのツリー接続を作成します。 このフラグは、デバイス ドライバーと中間ドライバーでは使用されません。 |
| FILE_COMPLETE_IF_OPLOCKED | 呼び出し元のスレッドをブロックするのではなく、ターゲット ファイルが日和見ロック (oplock) の場合は、STATUS_OPLOCK_BREAK_IN_PROGRESSの代替成功コードを使用して、この操作をすぐに完了します。 ファイルが oplocked の場合、別の呼び出し元は既にファイルにアクセスできます。 このフラグは、デバイス ドライバーと中間ドライバーでは使用されません。 oplock の詳細については、「 日和見ロック」を参照してください。 |
| FILE_NO_EA_KNOWLEDGE | 開かれている既存のファイルの拡張属性 (EA) が、呼び出し元がファイルを正しく解釈するために EA を理解する必要があることを示している場合、 ZwCreateFile はエラーを返す必要があります。 このフラグは、デバイスドライバーと中間ドライバーには関係ありません。 |
| FILE_OPEN_REPARSE_POINT | 再解析ポイントを使用してファイルを開き、ファイルの通常の再解析ポイント処理をバイパスします。 詳細については、「解説」を参照してください。 再解析ポイントの詳細については、「再解析 ポイント」を参照してください。 |
| FILE_DELETE_ON_CLOSE | ファイルへの最後のハンドルが ZwClose に渡されると、システムはファイルを削除します。 このフラグが設定されている場合は、 DesiredAccess パラメーターで DELETE フラグを設定する必要があります。 |
| FILE_OPEN_BY_FILE_ID | ObjectAttributes パラメーターで指定されるファイル名には、次に示すように、ファイル システムに応じて、ファイルのバイナリ 8 バイトまたは 16 バイトのファイル参照番号またはオブジェクト ID が含まれます。 必要に応じて、デバイス名の後に円記号を付けて、これらのバイナリ値を続行できます。 たとえば、デバイス名の形式は次のようになります。 ??\C:\FileID \device\HardDiskVolume1\ObjectID FileID は 8 バイト、ObjectID は 16 バイトです。 NTFS では、8 バイトまたは 16 バイトの参照番号またはオブジェクト ID を指定できます。 16 バイトの参照番号は、ゼロで埋め込まれた 8 バイトの数値と同じです。 ReFS では、8 バイトまたは 16 バイトの参照番号を指定できます。 16 バイトの数値は、8 バイトの数値とは関係ありません。 オブジェクト ID はサポートされていません。 FAT、ExFAT、UDFS、および CDFS ファイル システムでは、このフラグはサポートされていません。 この番号は によって割り当てられ、特定のファイル システムに固有です。 filename フィールドには部分的にバイナリ BLOB が含まれるため、これが有効な Unicode 文字列であると想定するのは正しくありません。さらに重要なのは、null で終わる文字列ではない可能性があります。 |
| FILE_OPEN_FOR_BACKUP_INTENT | バックアップの目的でファイルが開かれています。 したがって、システムは特定のアクセス権をチェックし、ファイルのセキュリティ記述子に対して DesiredAccess パラメーターをチェックする前に、呼び出し元にファイルへの適切なアクセス権を付与する必要があります。 このフラグは、デバイスドライバーと中間ドライバーでは使用されません。 |
| FILE_RESERVE_OPFILTER | このフラグを使用すると、アプリケーションはフィルターの日和見ロック (oplock) を要求して、他のアプリケーションが共有違反を受け取らないようにすることができます。 既に開いているハンドルがある場合、作成要求はSTATUS_OPLOCK_NOT_GRANTEDで失敗します。 詳細については、「解説」を参照してください。 oplock の詳細については、「 日和見ロック」を参照してください。 |
| FILE_OPEN_REQUIRING_OPLOCK | ファイルが開き、ファイルの日和見ロック (oplock) が 1 つのアトミック操作として要求されています。 ファイル システムは、作成操作を実行する前に oplock をチェックし、結果が既存の oplock を中断する場合は、STATUS_CANNOT_BREAK_OPLOCKのリターン コードで作成に失敗します。 FILE_OPEN_REQUIRING_OPLOCK フラグは、Windows 7、Windows Server 2008 R2 以降の Windows オペレーティング システムで使用できます。 |
| FILE_SESSION_AWARE | ファイルまたはデバイスを開くクライアントはセッションに対応しており、必要に応じてセッションごとのアクセスが検証されます。 FILE_SESSION_AWARE フラグは、Windows 8 以降で使用できます。 |
[in, optional] EaBuffer
デバイス ドライバーと中間ドライバーの場合、このパラメーターは NULL ポインターである必要があります。
[in] EaLength
デバイス ドライバーと中間ドライバーの場合、このパラメーターは 0 である必要があります。
戻り値
ZwCreateFile は 、成功した場合はSTATUS_SUCCESS、失敗した場合は適切な NTSTATUS エラー コードを返します。 後者の場合、呼び出し元は IoStatusBlock パラメーターを調べてエラーの原因を特定できます。
ZwCreateFile は、STATUS_FILE_LOCK_CONFLICTを戻り値として返すか、IoStatusBlock パラメーターによって指されるIO_STATUS_BLOCK構造体の Status メンバーで返される場合があります。 これは、NTFS ログ ファイルがいっぱいで、 ZwCreateFile がこの状況を処理しようとしたときにエラーが発生した場合にのみ発生します。
注釈
ZwCreateFile は、呼び出し元がファイルのデータ、またはファイル オブジェクトの状態と属性を操作するために使用できるハンドルを提供します。 詳細については、「 ドライバーでのファイルの使用」を参照してください。
FileHandle が指すハンドルが使用されなくなったら、ドライバーは ZwClose を呼び出して閉じる必要があります。
呼び出し元がシステム スレッド コンテキストで実行されていない場合は、作成するハンドルがプライベート ハンドルであることを確認する必要があります。 それ以外の場合は、ドライバーが実行されているコンテキスト内のプロセスによってハンドルにアクセスできます。 詳細については、「 オブジェクト ハンドル」を参照してください。
ZwCreateFile を使用して作成または開くファイルの名前を指定するには、次の 2 つの方法があります。
完全修飾パス名として、入力 ObjectAttributes の ObjectName メンバーで指定されます。
入力 ObjectAttributes の RootDirectory メンバーのハンドルによって表されるディレクトリ ファイルに対する相対パス名。
DesiredAccess パラメーターに特定のフラグを設定すると、次の効果が得られます。
呼び出し元が、返された FileHandle を待機して I/O 完了を同期するには、SYNCHRONIZE フラグを設定する必要があります。 それ以外の場合、デバイスまたは中間ドライバーである呼び出し元は、イベント オブジェクトを使用して I/O 完了を同期する必要があります。
呼び出し元が FILE_APPEND_DATA フラグと SYNCHRONIZE フラグのみを設定した場合、ファイルの末尾にのみ書き込み可能であり、ファイルへの書き込み操作に関するオフセット情報は無視されます。 ファイルは、この種類の操作に必要に応じて自動的に拡張されます。
ファイルのFILE_WRITE_DATA フラグを設定すると、呼び出し元はファイルの末尾を超えて書き込むこともできます。 この場合も、ファイルは必要に応じて自動的に拡張されます。
呼び出し元が FILE_EXECUTE フラグと SYNCHRONIZE フラグのみを設定した場合、返された FileHandle を使用してファイルにデータを直接読み取ったり書き込んだりすることはできません。 つまり、ファイルに対するすべての操作は、命令操作とデータ アクセス操作に応答してシステム ポケットベルを介して行われます。 デバイス ドライバーと中間ドライバーでは、FILE_EXECUTE フラグを設定しないでください。
ShareAccess パラメーターは、個別のスレッドが同じファイルに同時にアクセスできるかどうかを決定します。 両方の呼び出し元が適切なアクセス特権を持っている場合、ファイルを正常に開いて共有できます。 ZwCreateFile の元の呼び出し元がFILE_SHARE_READ、FILE_SHARE_WRITE、またはFILE_SHARE_DELETEを指定しない場合、他の呼び出し元はファイルを開けません。つまり、元の呼び出し元には排他的アクセスが許可されます。
共有ファイルを正常に開くには、 DesiredAccess フラグは、 を介してまだ解放されていない、以前に開いたすべての操作の DesiredAccess フラグと ShareAccess フラグと互換性がある必要があります。 つまり、特定のファイルに対して ZwCreateFile に指定された DesiredAccess は、ファイルの他の opener が許可していないアクセスと競合しないようにする必要があります。
CreateDisposition 値FILE_SUPERSEDE、呼び出し元が既存のファイル オブジェクトに対する DELETE アクセス権を持っている必要があります。 その場合、既存のファイルで FILE_SUPERSEDE を使用して ZwCreateFile を正常に呼び出すと、そのファイルが実質的に削除され、再作成されます。 これは、ファイルが既に別のスレッドによって開かれている場合は、FILE_SHARE_DELETE フラグが設定された ShareAccess パラメーターを指定してファイルを開くことを意味します。 この種類の処理は、ファイルを上書きする POSIX スタイルと一致することに注意してください。
CreateDisposition の値FILE_OVERWRITE_IFとFILE_SUPERSEDEは似ています。 既存のファイルで ZwCreateFile が呼び出され、これらの CreateDisposition 値のいずれかが呼び出された場合、ファイルは置き換えられます。
ファイルの上書きは、次を除き、置き換え操作と意味的に同等です。
呼び出し元は、アクセス権を削除するのではなく、ファイルへの書き込みアクセス権を持っている必要があります。 これは、ファイルが既に別のスレッドによって開かれている場合は、入力 ShareAccess で設定されたFILE_SHARE_WRITE フラグを使用してファイルを開くことを意味します。
指定されたファイル属性は、ファイルに既に存在する属性と論理的に ORed です。 これは、ファイルが既に別のスレッドによって開かれている場合、 ZwCreateFile の後続の呼び出し元は既存の FileAttributes フラグを無効にすることはできませんが、同じファイルに対して追加のフラグを有効にできることを意味します。
FILE_DIRECTORY_FILE CreateOptions 値は、作成または開くファイルがディレクトリであることを指定します。 ディレクトリ ファイルが作成されると、ファイル システムはディスク上に適切な構造を作成し、その特定のファイル システムのディスク上の構造の空のディレクトリを表します。 このオプションが指定されていて、開く指定されたファイルがディレクトリ ファイルではない場合、または呼び出し元が一貫性のない CreateOptions または CreateDisposition 値を指定した場合、 ZwCreateFile の呼び出しは失敗します。
CreateOptions フラグFILE_NO_INTERMEDIATE_BUFFERINGすると、ファイル システムが呼び出し元に代わって中間バッファリングを実行できなくなります。 このフラグを指定すると、呼び出し元のパラメーターに次の制限が設定され、他の ZwXxxファイル ルーチンに設定されます。
ZwReadFile または ZwWriteFile に渡される任意の ByteOffset は、セクター サイズの倍数である必要があります。
ZwReadFile または ZwWriteFile に渡される長さは、セクター サイズの整数である必要があります。 長さがセクター サイズであるバッファーに対して読み取り操作を指定すると、転送中にファイルの末尾に達した場合に、そのバッファーに転送される有効バイト数が少なくなる可能性があることに注意してください。
バッファーは、基になるデバイスの配置要件に従って配置する必要があります。 この情報を取得するには、 ZwCreateFile を呼び出して、物理デバイスを表すファイル オブジェクトのハンドルを取得し、そのハンドルを ZwQueryInformationFile に渡します。 システムのFILE_XXX_ALIGNMENT値の一覧については、「 DEVICE_OBJECT」を参照してください。
FileInformationClass パラメーターを FilePositionInformation に設定して ZwSetInformationFile を呼び出すには、セクター サイズの倍数であるオフセットを指定する必要があります。
FILE_SYNCHRONOUS_IO_ALERTと FILE_SYNCHRONOUS_IO_NONALERT CreateOptions フラグは、名前が示すとおりに相互に排他的であり、返された FileHandle によって参照されるファイル オブジェクトを介して行われる限り、ファイルに対するすべての I/O 操作が同期的であることを指定します。 このようなファイルのすべての I/O は、返されたハンドルを使用して、すべてのスレッドにわたってシリアル化されます。 これらの CreateOptions フラグのいずれかが設定されている場合は、SYNCHRONIZE DesiredAccess フラグも設定する必要があります。これにより、I/O マネージャーがファイル オブジェクトを同期オブジェクトとして使用するように強制されます。 このような場合、I/O マネージャーは現在のファイル位置オフセットを追跡します。このオフセットは ZwReadFile と ZwWriteFile に渡すことができます。 この位置を取得または設定するには、 ZwQueryInformationFile または ZwSetInformationFile を呼び出します。
CreateOptions FILE_OPEN_REPARSE_POINT フラグが指定されておらず、ZwCreateFile が再解析ポイントを使用してファイルを開こうとした場合、ファイルに対して通常の再解析ポイント処理が行われます。 一方、FILE_OPEN_REPARSE_POINT フラグが指定されている場合、通常の再解析処理は行われず、 ZwCreateFile は再解析ポイント ファイルを直接開こうとします。 どちらの場合も、開いている操作が成功した場合、 ZwCreateFile はSTATUS_SUCCESSを返します。それ以外の場合、ルーチンは NTSTATUS エラー コードを返します。 ZwCreateFile は STATUS_REPARSEを返しません。
CreateOptions FILE_OPEN_REQUIRING_OPLOCK フラグを使用すると、ファイルを開いて、サード パーティがファイルを開いて共有違反を受け取る可能性がある oplock を要求するまでの時間が不要になります。 アプリケーションは 、ZwCreateFile で FILE_OPEN_REQUIRING_OPLOCK フラグを使用し、任意の oplock を要求できます。 これにより、共有違反の原因となる後続のオープン要求が oplock 所有者に確実に通知されます。
Windows 7 では、アプリケーションが FILE_OPEN_REQUIRING_OPLOCK フラグを使用するときにファイルに他のハンドルが存在する場合、作成操作はSTATUS_OPLOCK_NOT_GRANTEDで失敗します。 この制限は、Windows 8以降は存在しません。
この作成操作によってファイルに既に存在する oplock が中断される場合、FILE_OPEN_REQUIRING_OPLOCK フラグを設定すると、作成操作は STATUS_CANNOT_BREAK_OPLOCK で失敗します。 この作成操作では、既存の oplock は破損しません。
FILE_OPEN_REQUIRING_OPLOCK フラグを使用するアプリケーションは、この呼び出しが成功した後に oplock を要求する必要があります。それ以降のファイルの開き方はすべてブロックされ、通常の oplock 処理の利点はありません。 同様に、この呼び出しが成功しても後続の oplock 要求が失敗した場合、このフラグを使用するアプリケーションは、oplock 要求が失敗したことを検出した後、ハンドルを閉じる必要があります。
FILE_OPEN_REQUIRING_OPLOCK フラグは、Windows 7、Windows Server 2008 R2 以降の Windows オペレーティング システムで使用できます。 Windows 7 でこのフラグを実装する Microsoft ファイル システムは、NTFS、FAT、exFAT です。
CreateOptions フラグ FILE_RESERVE_OPFILTERを使用すると、アプリケーションはレベル 1、バッチ、またはフィルター 操作ロックを要求して、他のアプリケーションが共有違反を受け取ることを防ぐことができます。 ただし、FILE_RESERVE_OPFILTERは、フィルター 操作ロックに対してのみ実用的に役立ちます。 これを使用するには、次の手順を実行する必要があります。
CreateOptions が FILE_RESERVE_OPFILTER、DesiredAccess が正確にFILE_READ_ATTRIBUTES、ShareAccess が正確にFILE_SHARE_READで作成要求を発行する |FILE_SHARE_WRITE |FILE_SHARE_DELETE。
既に開いているハンドルがある場合、作成要求はSTATUS_OPLOCK_NOT_GRANTEDで失敗し、次に要求された oplock も失敗します。
より多くのアクセス権またはより少ない共有で開くと、STATUS_OPLOCK_NOT_GRANTEDのエラーも発生します。
作成要求が成功した場合は、oplock を要求します。
ファイルの別のハンドルを開いて I/O を実行します。
手順 3 では、フィルター 操作ロックに対してのみこれを実用的にします。 手順 3 で開いたハンドルには、最大FILE_READ_ATTRIBUTESを含む DesiredAccess を含めることができます。 |FILE_WRITE_ATTRIBUTES |FILE_READ_DATA |FILE_READ_EA |FILE_EXECUTE |SYNCHRONIZE |READ_CONTROLし、フィルター 操作ロックを中断しません。 ただし、 desiredAccess が FILE_READ_ATTRIBUTES より大きい場合 |FILE_WRITE_ATTRIBUTES |SYNCHRONIZE では、レベル 1 または Batch oplock が中断され、FILE_RESERVE_OPFILTER フラグは使用できなくなります。
NTFS は、FILE_RESERVE_OPFILTERを実装する唯一の Microsoft ファイル システムです。
ZwCreateFile の呼び出し元は、IRQL = PASSIVE_LEVELで実行され、特殊なカーネル APCs が有効になっている必要があります。
この関数の呼び出しがユーザー モードで行われる場合は、"ZwCreateFile" ではなく "NtCreateFile" という名前を使用する必要があります。
カーネル モード ドライバーからの呼び出しの場合、Windows ネイティブ システム サービス ルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なる場合があります。 ルーチンの NtXxx バージョンと ZwXxx バージョンの間の関係の詳細については、「ネイティブ システム サービス ルーチンの Nt バージョンと Zw バージョンの使用」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL (「解説」セクションを参照) |
| DDI コンプライアンス規則 | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示