fltOplockFsctrl 函式 (fltkernel.h)

發行項
02/29/2024

FltOplockFsctrl 代表迷你篩選驅動程序執行各種 oplock (oplock) 作業。

語法

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

參數

[in] Oplock

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

[in] CallbackData

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

[in] OpenCount

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

傳回值

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參數的詳細資訊，請參閱 FLT_PARAMETERS for IRP_MJ_FILE_SYSTEM_CONTROL。

如需有關商機鎖定的詳細資訊，請參閱 Microsoft Windows SDK 檔。

如果作業是 IRP_MJ_CREATE 要求，如果下列所有條件都成立， 則可以使用 FltOplockFsctrl 來要求擱置篩選機率鎖定：

OpenCount 參數的值必須是 1。
IRP_MJ_CREATE要求的 DesiredAccess 參數值是FILE_READ_ATTRIBUTES。此參數是在作業FLT_PARAMETERS結構的 SecurityContext 成員中設定。如需詳細資訊，請參閱 FLT_PARAMETERS for IRP_MJ_CREATE。
IRP_MJ_CREATE作業的 ShareAccess 參數值是FILE_SHARE_READ、FILE_SHARE_WRITE或FILE_SHARE_DELETE。此參數是在作業FLT_PARAMETERS結構的 ShareAccess 成員中設定。如需詳細資訊，請參閱 FLT_PARAMETERS for IRP_MJ_CREATE。

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