PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK função de retorno de chamada (wdm.h)

Artigo
02/07/2025

A função ClfsLogGrowthCompleteCallback implementa as ações que o cliente executará quando o espaço for liberado em um log que já estava cheio.

Sintaxe

PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK PclfsClientLffHandlerCompleteCallback;

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

Parâmetros

[in] LogFile

Um ponteiro para uma estrutura de LOG_FILE_OBJECT que representa o fluxo de log CLFS cujo log terminou de crescer.

[in] OperationStatus

O status da solicitação anterior do cliente para lidar com uma condição completa do arquivo de log. Isso será STATUS_SUCCESS ou um status de erro que indica o motivo pelo qual a solicitação não pôde ser concluída com êxito.

[in] LogIsPinned

Se TRUE, especifica que a parte final do log está fixada no momento; false se a parte final do log não estiver fixada.

[in] ClientData

Um ponteiro para informações fornecidas pelo cliente.

Valor de retorno

Nenhum

Observações

Como uma chamada para ClfsMgmtHandleLogFileFull é concluída de forma assíncrona, todas as ações que o cliente executará quando a condição completa do arquivo de log tiver sido manipulada pertencem à função ClfsLogGrowthCompleteCallback.

Se uma chamada ao ClfsMgmtHandleLogFileFull rotina retornada retornar STATUS_PENDING, a função ClfsLogGrowthCompleteCallback será invocada quando a operação for concluída. Se um status diferente tiver sido retornado, a função ClfsLogGrowthCompleteCallback não será invocada.

A função ClfsLogGrowthCompleteCallback deve executar apenas uma quantidade mínima de processamento antes de retornar. Por exemplo, a função ClfsLogGrowthCompleteCallback pode seguir o seguinte procedimento:

Se o valor do parâmetro OperationStatus for um status de erro, retorne.
Se o valor do parâmetro OperationStatus for STATUS_SUCCESS, crie e enfileira um item de trabalho para informar ao cliente que ele pode retomar o processamento.

Quando um cliente usa a rotina de ClfsMgmtRegisterManagedClient para se registrar no gerenciamento CLFS, o cliente fornece um ponteiro para a função ClfsLogGrowthCompleteCallback e os dados personalizados que serão passados como um parâmetro para a função ClfsLogGrowthCompleteCallback quando essa função for chamada.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte no Windows Server 2003 R2, Windows Vista e versões posteriores do Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL	Chamado no <DO IRQL = APC_LEVEL

Consulte também

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient

Compartilhar via