FltOplockFsctrlEx 函式（fltkernel.h）

發行項
12/21/2024

FltOplockFsctrlEx 例程代表迷你篩選驅動程式執行各種機會鎖定（oplock）作業。

語法

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

參數

[in] Oplock

檔案的不透明不透明指標。此指標必須由先前呼叫 FltInitializeOplock初始化。

[in] CallbackData

I/O 作業 FLT_CALLBACK_DATA 結構的指標。這是必要參數，而且無法 NULL。

[in] OpenCount

如果要求獨佔 oplock，檔案的使用者句柄數目。設定層級 2、R 或 RH oplock 要求的非零值，表示檔案上有位元組範圍鎖定。如需 oplock 類型的相關信息，請參閱 Oplock 概觀。

[in] Flags

相關聯 oplock 作業的位掩碼。迷你篩選驅動程式會設定位，以指定 FltOplockFsctrlEx的行為。 Flags 參數具有下列選項：

價值	意義
OPLOCK_FSCTRL_FLAG_ALL_KEYS_MATCH （0x00000001）	檔系統已驗證目前開啟相符之任何句柄上的所有 oplock 機碼。藉由指定此旗標，您可以在檔案存在多個開啟句柄時，允許 oplock 套件授與層級 RW 或 RWH 的 oplock。如需 oplock 類型的詳細資訊，請參閱 Oplock 概觀。

傳回值

FltOplockFsctrlEx 會針對某些 FSCTL 作業傳回FLT_PREOP_PENDING。如需詳細資訊，請參閱下列一節所列之 FSCTL 代碼的參考頁面。否則，FltOplockFsctrlEx 會傳回FLT_PREOP_COMPLETE。

言論

小型篩選驅動程式會呼叫 FltOplockFsctrlEx，以針對建立作業或文件系統控制 I/O 作業執行各種機會鎖定作業。

CallbackData 參數所指向的 FLT_CALLBACK_DATA 結構必須代表以 IRP 為基礎的 IRP_MJ_FILE_SYSTEM_CONTROL 或 IRP_MJ_CREATE 作業。

如果作業是IRP_MJ_FILE_SYSTEM_CONTROL作業，FltOplockFsctrlEx 可以搭配下列 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 成員中設定。如需詳細資訊，請參閱 FLT_PARAMETERS IRP_MJ_CREATE。
IRP_MJ_CREATE作業的 ShareAccess 參數值是FILE_SHARE_READ、FILE_SHARE_WRITE或FILE_SHARE_DELETE。此參數是在作業FLT_PARAMETERS結構的 ShareAccess 成員中設定。如需詳細資訊，請參閱 FLT_PARAMETERS IRP_MJ_CREATE。

呼叫此函式的篩選和文件系統必須將呼叫同步處理至系統提供的 oplock 套件。如需詳細資訊，請參閱 Oplock 同步處理。

要求

要求	價值
最低支援的用戶端	從 Windows 8 開始，即可使用此例程。
目標平臺	普遍
標頭	fltkernel.h （包括 Fltkernel.h）
連結庫	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL