FsRtlOplockFsctrlEx 関数 (ntifs.h)

[アーティクル]
12/20/2024

FsRtlOplockFsctrlEx ルーチンは、ファイルシステムまたはフィルタードライバーに代わって、さまざまな日和見ロック (oplock) 操作を実行します。

構文

NTSTATUS FsRtlOplockFsctrlEx(
  [in] POPLOCK Oplock,
  [in] PIRP    Irp,
  [in] ULONG   OpenCount,
  [in] ULONG   Flags
);

パラメーター

[in] Oplock

ファイルの不透明な oplock ポインター。このポインターは、FsRtlInitializeOplockへの以前の呼び出しによって初期化されている必要があります。

[in] Irp

I/O 操作の IRP へのポインター。このパラメーターは必須であり、NULLすることはできません。

[in] OpenCount

排他 oplock が要求されている場合の、ファイルのユーザーハンドルの数。レベル 2、R、または RH oplock 要求に 0 以外の値を設定すると、ファイルにバイト範囲ロックがあることを示します。 oplock 型の詳細については、「Oplock Overview」を参照してください。

[in] Flags

関連付けられている oplock 操作のビットマスク。ファイルシステムまたはフィルタードライバーは、fsRtlOplockFsctrlExの動作指定するビットを設定します。このパラメーターには、次のオプションがあります。

旗	意味
OPLOCK_FSCTRL_FLAG_ALL_KEYS_MATCH (0x00000001)	ファイルシステムは、現在開いているハンドルのすべての oplock キーが一致することを確認しました。このフラグを指定すると、ファイルに対する複数のオープンハンドルが存在する場合に、oplock パッケージがレベル RW または RWH の oplock を許可できるようになります。 oplock 型の詳細については、「oplock の概要を参照してください。

旗

意味

OPLOCK_FSCTRL_FLAG_ALL_KEYS_MATCH (0x00000001)

ファイルシステムは、現在開いているハンドルのすべての oplock キーが一致することを確認しました。このフラグを指定すると、ファイルに対する複数のオープンハンドルが存在する場合に、oplock パッケージがレベル RW または RWH の oplock を許可できるようになります。 oplock 型の詳細については、「oplock の概要を参照してください。

戻り値

FsRtlOplockFsctrlEx は、次のいずれかの NTSTATUS 値を返します。

リターンコード	形容
STATUS_SUCCESS	IRP_MJ_CREATE要求の場合、STATUS_SUCCESSは、要求されたフィルター oplock が許可されたことを示します。 FSCTL 操作の場合、STATUS_SUCCESSの意味は FSCTL コードによって異なります。詳細については、次の「解説」セクションに記載されている FSCTL コードのリファレンスページを参照してください。
STATUS_CANCELLED	I/O 操作が取り消されました。 STATUS_CANCELLEDはエラーコードです。
STATUS_INVALID_PARAMETER	I/O 操作の FSCTL コードは、次の「解説」セクションに記載されている有効な値の 1 つではありません。 STATUS_INVALID_PARAMETERはエラーコードです。
STATUS_OPLOCK_NOT_GRANTED	oplock を許可できませんでした。 STATUS_OPLOCK_NOT_GRANTEDはエラーコードです。
STATUS_PENDING	FSCTL 操作にのみ使用されます。 STATUS_PENDINGの意味は、FSCTL コードによって異なります。詳細については、次の「解説」セクションに記載されている FSCTL コードのリファレンスページを参照してください。 STATUS_PENDINGは成功コードです。
STATUS_CANNOT_BREAK_OPLOCK	新しい oplock を許可できませんでした。 IRP はIRP_MJ_CREATE要求であり、操作の作成オプションパラメーターにFILE_OPEN_REQUIRING_OPLOCKが指定されています。 STATUS_CANNOT_BREAK_OPLOCKは成功コードです。

備考

ファイルシステムとレガシフィルタードライバー FsRtlOplockFsctrlEx を呼び出して、作成またはファイルシステムコントロールの I/O 操作に対してさまざまな oplock 操作を実行します。ミニフィルターでは、FsRtlOplockFsctrlEx ではなく、FltOplockFsctrlEx 呼び出す必要があります。

Irp パラメーターが指す IRP は、IRP_MJ_FILE_SYSTEM_CONTROL または IRP_MJ_CREATE 操作の有効な IRP である必要があります。

IRP が IRP_MJ_FILE_SYSTEM_CONTROL 要求である場合、FsRtlOplockFsctrlEx は、IrpSp-Parameters.FileSystemControl.FsControlCodeで設定次のいずれかの FSCTL コードで使用できます。

これらの FSCTL と一般的な日和見ロックの詳細については、Microsoft Windows SDK のドキュメントを参照してください。

IRP がIRP_MJ_CREATE要求の場合、fsRtlOplockFsctrlEx 使用して、次の条件がすべて満たされている場合に保留中のフィルター操作ロックを要求できます。

OpenCount パラメーターの値は 1 である必要があります。
IRP_MJ_CREATE要求の DesiredAccess パラメーターの値をFILE_READ_ATTRIBUTESする必要があります。
IRP_MJ_CREATE要求の ShareAccess パラメーターの値はFILE_SHARE_READする必要があります |FILE_SHARE_WRITE |FILE_SHARE_DELETE。

保留中のフィルター oplock の要求が許可されている場合、fsRtlOplockFsctrlEx はSTATUS_SUCCESSを返します。パラメーターの作成の詳細については、IRP_MJ_CREATEのリファレンスエントリを参照してください。

この関数を呼び出すフィルターとファイルシステムは、システム提供の oplock パッケージに呼び出しを同期する必要があります。詳細については、oplock 同期のを参照してください。

必要条件

要件	価値
サポートされる最小クライアント	FsRtlOplockFsctrlEx ルーチンは、Windows 7 以降で使用できます。
ターゲットプラットフォームの	万国
ヘッダー	ntifs.h (Ntifs.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

次の方法で共有

FsRtlOplockFsctrlEx 関数 (ntifs.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース