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

Статья
02/07/2025

Функция ClfsAdvanceTailCallback перемещает базовый номер последовательности журналов (LSN) журнала клиента.

Синтаксис

PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK PclfsClientAdvanceTailCallback;

NTSTATUS PclfsClientAdvanceTailCallback(
  [in] PLOG_FILE_OBJECT LogFile,
  [in] PCLFS_LSN TargetLsn,
  [in] PVOID ClientData
)
{...}

Параметры

[in] LogFile

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

[in] TargetLsn

Указатель на структуру CLFS_LSN, содержащую LSN, к которому клиент должен перейти к хвосту или за ее пределами.

[in] ClientData

Указатель на предоставленные клиентом сведения. Эти данные указываются в элементе AdvanceTailCallbackData структуры CLFS_MGMT_CLIENT_REGISTRATION.

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

Функция clfsAdvanceTailCallback должна возвращать STATUS_PENDING или состояние ошибки. Возвращаемое значение STATUS_PENDING указывает, что запрос на перемещение хвоста журнала клиента будет завершен асинхронно. Функция ClfsMgmtAdvanceTailCallback не должна возвращать STATUS_SUCCESS, даже если она завершается синхронно.

Замечания

Функция ClfsAdvanceTailCall back вызывается, когда управление CLFS запрашивает, что клиент перемещает хвост журнала.

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

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

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

Требования

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

См. также

CLFS_MGMT_CLIENT_REGISTRATION

ClfsAdvanceLogBase

ClfsMgmtRegisterManagedClient

ClfsMgmtTailAdvanceFailure

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