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

  • Artigo

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

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 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 erro status 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.

Retornar valor

Nenhum

Comentários

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 tratada pertencem à função ClfsLogGrowthCompleteCallback .

Se uma chamada para a rotina ClfsMgmtHandleLogFileFull 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:

  1. Se o valor do parâmetro OperationStatus for um erro status, retorne.
  2. 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 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
Cliente mínimo com suporte Com suporte no Windows Server 2003 R2, Windows Vista e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL Chamado em IRQL <= APC_LEVEL

Confira também

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient