FltAllocateFileLock 函式 (fltkernel.h)
FltAllocateFileLock 例程會配置並初始化新的FILE_LOCK結構。
語法
PFILE_LOCK FLTAPI FltAllocateFileLock(
[in, optional] PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE CompleteLockCallbackDataRoutine,
[in, optional] PUNLOCK_ROUTINE UnlockRoutine
);
參數
[in, optional] CompleteLockCallbackDataRoutine
完成IRP_MJ_LOCK_CONTROL要求時所呼叫之PFLT_COMPLETE_LOCK_CALLBACK_DATA_ROUTINE型別回呼例程的指標。 此參數是選擇性的，可以是 NULL。
[in, optional] UnlockRoutine
當位元組範圍解除鎖定時，要呼叫 之PUNLOCK_ROUTINE型別回呼例程的指標。 此參數是選擇性的，可以是 NULL。
傳回值
FltAllocateFileLock 會傳回新配置 之FILE_LOCK 結構的指標。
備註
FltAllocateFileLock 會從分頁集區配置新的 FILE_LOCK 結構，並將其初始化。
傳回 的FILE_LOCK 結構可用來藉由呼叫 FltProcessFileLock 來鎖定檔案中的位元組範圍。
不再需要 FILE_LOCK 結構時，呼叫 FltUninitializeFileLock 即可取消初始化。 然後呼叫 FltInitializeFileLock，即可初始化未初始化FILE_LOCK結構以供重複使用。
若要釋放初始化 FILE_LOCK 結構，請呼叫 FltFreeFileLock。
當傳遞至 FltProcessFileLock 的 CallbackData 參數代表快速的 I/O 作業時，不會叫用 CompleteLockCallbackDataRoutine 中指定的回呼。 只有在 CallbackData 中的 I/O 作業是 IRP， 而 CompleteLockCallbackDataRoutine 不是 NULL 時，才會呼叫回呼例程。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP SP2 |
| 最低支援的伺服器 | Windows Server 2003 SP1 |
| 目標平台 | Universal |
| 標頭 | fltkernel.h (包含 Fltkernel.h) |
| 程式庫 | FltMgr.lib |
| IRQL | <= APC_LEVEL |