FltInitializeFileLock function (fltkernel.h)
The FltInitializeFileLock routine initializes an opaque FILE_LOCK structure that the caller has allocated from paged pool.
Syntax
VOID FLTAPI FltInitializeFileLock(
[out] PFILE_LOCK FileLock
);
Parameters
[out] FileLock
Pointer to an uninitialized FILE_LOCK structure.
Return value
None
Remarks
The FILE_LOCK structure is opaque: that is, its members are reserved for system use.
Once initialized, the FILE_LOCK structure can be used to lock a byte range in a file by calling FltProcessFileLock.
It is a programming error to call FltInitializeFileLock for a FILE_LOCK structure that has already been initialized by FltInitializeFileLock or FltAllocateFileLock, unless the structure has been uninitialized by a subsequent call to FltUninitializeFileLock.
When the FILE_LOCK structure is no longer needed, it can be uninitialized by calling FltUninitializeFileLock. The uninitialized FILE_LOCK structure can then be initialized for reuse by calling FltInitializeFileLock.
To allocate and initialize a new opaque FILE_LOCK structure, call FltAllocateFileLock.
To free an initialized FILE_LOCK structure, call FltFreeFileLock.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP SP2 |
| Minimum supported server | Windows Server 2003 SP1 |
| Target Platform | Universal |
| Header | fltkernel.h (include Fltkernel.h) |
| Library | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |