функция обратного вызова PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK (wdm.h)

Статья
02/07/2025

Функция ClfsLogGrowthCompleteCallback реализует действия, которые клиент будет принимать при освобождении пространства в журнале, который ранее был заполнен.

Синтаксис

PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK PclfsClientLffHandlerCompleteCallback;

void PclfsClientLffHandlerCompleteCallback(
  [in] PLOG_FILE_OBJECT LogFile,
  [in] NTSTATUS OperationStatus,
  [in] BOOLEAN LogIsPinned,
  [in] PVOID ClientData
)
{...}

Параметры

[in] LogFile

Указатель на структуру LOG_FILE_OBJECT, представляющую поток журналов CLFS, журнал которого закончился.

[in] OperationStatus

Состояние предыдущего запроса клиента для обработки полного условия файла журнала. Это будет либо STATUS_SUCCESS, либо состояние ошибки, указывающее причину успешного завершения запроса.

[in] LogIsPinned

Если TRUE, указывает, что хвост журнала в настоящее время закреплен; FALSE, если хвост журнала не закреплен.

[in] ClientData

Указатель на предоставленные клиентом сведения.

Возвращаемое значение

Никакой

Замечания

Так как вызов ClfsMgmtHandleLogFileFull выполняется асинхронно, все действия, которые будет выполнять клиент при выполнении полного условия файла журнала, относятся к функции ClfsLogGrowthCompleteCallback.

Если вызов ClfsMgmtHandleLogFileFull возвращает STATUS_PENDING, функция ClfsLogGrowthCompleteCall back будет вызываться при завершении операции. Если было возвращено другое состояние, функция ClfsLogGrowthCompleteCallback не будет вызвана.

Функция clfsLogGrowthCompleteCallback должна выполнять только минимальный объем обработки перед возвратом. Например, функция clfsLogGrowthCompleteCallback может следовать следующей процедуре:

Если значение параметра OperationStatus является состоянием ошибки, возвращается.
Если значение параметра OperationStatus STATUS_SUCCESS, создайте и в очереди рабочий элемент, чтобы сообщить клиенту, что он может возобновить обработку.

Когда клиент использует подпрограмму clfsMgmtRegisterManagedClient для регистрации с помощью управления CLFS, клиент предоставляет указатель на функцию ClfsLogGrowthCompleteCallback и пользовательские данные, которые будут переданы в качестве параметра функции ClfsLogGrowthCompleteCallback при вызове этой функции.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в Windows Server 2003 R2, Windows Vista и более поздних версиях Windows.
целевая платформа	Настольный
заголовка	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL	Вызывается в IRQL <= APC_LEVEL

См. также

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient

Поделиться через