Функция FltInitializeFileLock (fltkernel.h)
Подпрограмма FltInitializeFileLock инициализирует непрозрачную структуру FILE_LOCK , выделенную вызывающим объектом из выгружаемого пула.
Синтаксис
VOID FLTAPI FltInitializeFileLock(
[out] PFILE_LOCK FileLock
);
Параметры
[out] FileLock
Указатель на неинициализированную структуру FILE_LOCK .
Возвращаемое значение
None
Remarks
Структура FILE_LOCK непрозрачна: то есть ее члены зарезервированы для использования системой.
После инициализации структуру FILE_LOCK можно использовать для блокировки диапазона байтов в файле, вызвав FltProcessFileLock.
Вызов FltInitializeFileLock для FILE_LOCK структуры, которая уже была инициализирована FltInitializeFileLock или FltAllocateFileLock, является ошибкой программирования, если только структура не была не инициализирована последующим вызовом FltUninitializeFileLock.
Если структура FILE_LOCK больше не нужна, ее можно не инициализировать, вызвав FltUninitializeFileLock. Затем неинициализированную структуру FILE_LOCK можно инициализировать для повторного использования, вызвав FltInitializeFileLock.
Чтобы выделить и инициализировать новую непрозрачную структуру FILE_LOCK , вызовите FltAllocateFileLock.
Чтобы освободить инициализированную структуру FILE_LOCK , вызовите FltFreeFileLock.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP с пакетом обновления 2 (SP2) |
Минимальная версия сервера | Windows Server 2003 с пакетом обновления 1 (SP1) |
Целевая платформа | Универсальное |
Верхняя часть | fltkernel.h (включая Fltkernel.h) |
Библиотека | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |