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

Статья
08/08/2023

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

Синтаксис

PCLFS_CLIENT_LOG_UNPINNED_CALLBACK PclfsClientLogUnpinnedCallback;

void PclfsClientLogUnpinnedCallback(
  [in] PLOG_FILE_OBJECT LogFile,
  [in] PVOID ClientData
)
{...}

Параметры

[in] LogFile

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

[in] ClientData

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

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

None

Remarks

Если клиент вызывал подпрограмму ClfsMgmtHandleLogFileFull и управление CLFS впоследствии вызывал функцию ClfsLogGrowthCompleteCallback клиента со значением TRUE для параметра LogIsPinned , то функция ClfsLogUnpinnedCallback будет вызываться, когда журнал будет откреплен.

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

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

Функция ClfsLogGrowthCompleteCallback вызывается перед функцией ClfsLogUnpinnedCallback .

Требования

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

См. также раздел

CLFS_MGMT_CLIENT_REGISTRATION

ClfsMgmtHandleLogFileFull

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