FltOplockFsctrl 関数 (fltkernel.h)

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

FltOplockFsctrl 、ミニフィルタードライバーに代わってさまざまな日和見ロック (oplock) 操作を実行します。

構文

FLT_PREOP_CALLBACK_STATUS FLTAPI FltOplockFsctrl(
  [in] POPLOCK            Oplock,
  [in] PFLT_CALLBACK_DATA CallbackData,
  [in] ULONG              OpenCount
);

パラメーター

[in] Oplock

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

[in] CallbackData

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

[in] OpenCount

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

戻り値

FltOplockFsctrl は、一部の FSCTL 操作のFLT_PREOP_PENDINGを返します。詳細については、次の「解説」セクションに記載されている FSCTL コードのリファレンスページを参照してください。それ以外の場合 FltOplockFsctrl はFLT_PREOP_COMPLETEを返します。

備考

ミニフィルタードライバーは、FltOplockFsctrl 呼び出して、作成またはファイルシステムコントロールの I/O 操作に対してさまざまな日和見ロック操作を実行します。

CallbackData パラメーターが指す FLT_CALLBACK_DATA 構造体は、IRP ベースの IRP_MJ_FILE_SYSTEM_CONTROL または IRP_MJ_CREATE 操作を表す必要があります。

操作がIRP_MJ_FILE_SYSTEM_CONTROL操作である場合、FltOplockFsctrl 次の FSCTL コードと共に使用できます。

FSCTL コードは、操作の FLT_PARAMETERS 構造体の FsControlCode メンバーで設定されます。 FsControlCode およびその他のIRP_MJ_FILE_SYSTEM_CONTROL パラメーター詳細については、IRP_MJ_FILE_SYSTEM_CONTROLの FLT_PARAMETERS を参照してください。

日和見ロックの詳細については、Microsoft Windows SDK のドキュメントを参照してください。

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

OpenCount パラメーターの値は 1 である必要があります。
IRP_MJ_CREATE要求の DesiredAccess パラメーターの値がFILE_READ_ATTRIBUTES。このパラメーターは、操作のFLT_PARAMETERS構造体の SecurityContext メンバーで設定されます。詳細については、IRP_MJ_CREATEの FLT_PARAMETERS を参照してください。
IRP_MJ_CREATE操作の ShareAccess パラメーターの値は、FILE_SHARE_READ、FILE_SHARE_WRITE、またはFILE_SHARE_DELETEです。このパラメーターは、操作のFLT_PARAMETERS構造体の ShareAccess メンバーで設定されます。詳細については、IRP_MJ_CREATEの FLT_PARAMETERS を参照してください。

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

必要条件

要件	価値
ターゲットプラットフォームの	万国
ヘッダー	fltkernel.h (Fltkernel.h を含む)
ライブラリ	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL

次の方法で共有

FltOplockFsctrl 関数 (fltkernel.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース