Функция ClfsMgmtHandleLogFileFull (wdm.h)
Подпрограмма ClfsMgmtHandleLogFileFull пытается освободить больше места в журнале. Это может сделать больше свободного места, добавив контейнеры в журнал, или попросить клиентов переместить их хвосты журнала.
Синтаксис
CLFSUSER_API NTSTATUS ClfsMgmtHandleLogFileFull(
[in] CLFS_MGMT_CLIENT Client
);
Параметры
[in] Client
Клиент, запрашивающий управление CLFS, чтобы освободить место в журнале. Значение этого параметра должно быть структурой CLFS_MGMT_CLIENT , полученной посредством вызова подпрограммы ClfsMgmtRegisterManagedClient .
Возвращаемое значение
Подпрограмма ClfsMgmtHandleLogFileFull возвращает одно из следующих значений NTSTATUS:
| Код возврата | Описание |
|---|---|
| STATUS_INVALID_PARAMETER | Клиент не управляет журналом. |
| STATUS_INVALID_PARAMETER_1 | Значение, указанное для параметра Client , равно NULL или не представляет допустимый клиент. |
| STATUS_LOG_FULL_HANDLER_IN_PROGRESS | Управление CLFS уже пытается разрешить полное условие файла журнала для этого клиента. |
| STATUS_UNSUCCESSFUL | Управлению CLFS не удалось обработать запрос. |
| STATUS_PENDING | Управление CLFS обрабатывает запрос на создание пространства в журнале. |
| STATUS_SUCCESS | Запрошенный объем свободного места доступен в журнале. |
Комментарии
Чтобы освободить больше места в журнале, подпрограмма ClfsMgmtHandleLogFileFull сначала пытается добавить в журнал дополнительные контейнеры в соответствии с темпами роста, новыми размерами контейнеров и политиками максимального размера. Если не удается добавить больше контейнеров, то подпрограмма ClfsMgmtHandleLogFileFull пытается освободить существующее пространство, вызывая одну или несколько функций ClfsAdvanceTailCallback клиентов.
Если подпрограмма ClfsMgmtHandleLogFileFull возвращает STATUS_PENDING, функция ClfsLogGrowthCompleteCallback клиента будет вызываться при выполнении запроса на создание места в журнале.
Если подпрограмма ClfsMgmtHandleLogFileFull возвращает STATUS_LOG_FULL_HANDLER_IN_PROGRESS, клиент уже запросил управление CLFS для обработки полного условия файла журнала. Функция ClfsLogGrowthCompleteCallback клиента не будет вызываться повторно.
Если подпрограмма ClfsMgmtHandleLogFileFull возвращает STATUS_SUCCESS, вызов выполняется синхронно, а функция ClfsLogGrowthCompleteCallback клиента вызываться не будет.
Если подпрограмма ClfsMgmtHandleLogFileFull возвращает STATUS_PENDING, то управление CLFS пытается освободить место в журнале и вызовет функцию ClfsLogGrowthCompleteCallback клиента при обработке полного условия файла журнала. Если журнал закреплен, управление CLFS вызовет функцию ClfsLogGrowthCompleteCallback клиента с параметром LogIsPinned , равным TRUE , прежде чем подпрограмма ClfsMgmtHandleLogFileFull вернет STATUS_PENDING.
Возможно, функция ClfsLogGrowthCompleteCallback клиента может быть вызвана до возврата вызова ClfsMgmtHandleLogFileFull .
Если подпрограмма ClfsMgmtHandleLogFileFull возвращает STATUS_PENDING, не следует повторно вызывать подпрограмму ClfsMgmtHandleLogFileFull для этого клиента, пока не будет вызвана функция ClfsLogGrowthCompleteCallback клиента.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h) |
| Библиотека | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | IRQL <= APC_LEVEL |