FltProcessFileLock 函式 (fltkernel.h)

發行項
02/29/2024

FltProcessFileLock 例程會處理並完成檔案鎖定作業。

語法

FLT_PREOP_CALLBACK_STATUS FLTAPI FltProcessFileLock(
  [in]           PFILE_LOCK         FileLock,
  [in]           PFLT_CALLBACK_DATA CallbackData,
  [in, optional] PVOID              Context
);

參數

[in] FileLock

檔案 FILE_LOCK 結構的指標。這個結構必須由先前呼叫 FltAllocateFileLock 或 FltInitializeFileLock 初始化。

[in] CallbackData

IRP_MJ_LOCK_CONTROL作業的回呼數據指標 (FLT_CALLBACK_DATA) 結構。

[in, optional] Context

完成作業時要使用的內容指標。此內容指標會傳遞至 CompleteLockCallbackDataRoutine 和 UnlockRoutine 回呼例程，此例程是 Minifilter 驅動程式在先前呼叫 FltAllocateFileLock 中註冊的。此參數是選擇性的，可以是 NULL。

傳回值

FltProcessFileLock 會傳回下列其中一項。

傳回碼	Description
FLT_PREOP_COMPLETE	篩選管理員是使用 CallbackData 完成的，現在可以完成。
FLT_PREOP_DISALLOW_FASTIO	CallbackData 代表快速 I/O 作業，而堆疊中的迷你篩選驅動程式不允許用於此作業的快速 I/O。篩選管理員不會將作業傳送至不允許作業的任何迷你篩選驅動程式。在此情況下，篩選管理員只會 (和 CompleteLockCallbackDataRoutine 回呼呼叫後置回呼) 迷你篩選器驅動程式上方不允許快速 I/O 作業的迷你篩選器驅動程式。
FLT_PREOP_PENDING	鎖定作業已畫筆。

備註

FltProcessFileLock 會處理檔案鎖定 (IRP_MJ_LOCK_CONTROL) 作業。鎖定作業可以是快速 I/O 或 IRP 型作業。

針對解除鎖定作業，篩選管理員會呼叫呼叫端在先前呼叫 FltAllocateFileLock 中註冊FILE_LOCK結構的 UnlockRoutine 回呼例程。

當鎖定作業完成時，篩選管理員會呼叫 CompleteLockCallbackDataRoutine (PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE) 完成回呼例程，呼叫端在先前呼叫 FltAllocateFileLock 中註冊FILE_LOCK結構。

當傳遞至 FltProcessFileLock 的 CallbackData 參數代表快速的 I/O 作業時，不會叫用 FltAllocateFileLock 例程之 CompleteLockCallbackDataRoutine 參數中指定的回呼。只有在 CallbackData 中的 I/O 作業是 IRP， 而 CompleteLockCallbackDataRoutine 不是 NULL 時，才會呼叫回呼例程。

若要判斷 CallbackData 是否代表快速的 I/O 作業，請使用 FLT_IS_FASTIO_OPERATION 宏。

若要配置並初始化新的檔案鎖定結構，請呼叫 FltAllocateFileLock。

若要釋放初始化 FILE_LOCK 結構，請呼叫 FltFreeFileLock。

規格需求

需求	值
最低支援的用戶端	Windows XP 含 SP2
最低支援的伺服器	Windows Server 2003 SP1
目標平台	Universal
標頭	fltkernel.h (包含 Fltkernel.h)
程式庫	FltMgr.lib
Dll	Fltmgr.sys
IRQL	<= APC_LEVEL