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

Artigo
07/02/2025

A função ClfsAdvanceTailCallback avança o LSN (número de sequência de log base) do log do cliente.

Sintaxe

C++

PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK PclfsClientAdvanceTailCallback;

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

Parâmetros

[in] LogFile

Um ponteiro para uma estrutura de LOG_FILE_OBJECT que representa o fluxo de log CLFS cuja cauda deve ser avançada.

[in] TargetLsn

Um ponteiro para uma estrutura de CLFS_LSN que contém o LSN para o qual o cliente deve avançar sua cauda para ou além.

[in] ClientData

Um ponteiro para informações fornecidas pelo cliente. Especifique esses dados no membro AdvanceTailCallbackData da estrutura CLFS_MGMT_CLIENT_REGISTRATION.

Valor de retorno

A função ClfsAdvanceTailCallback deve retornar STATUS_PENDING ou um status de erro. Um valor retornado de STATUS_PENDING indica que a solicitação para mover a parte final do log do cliente será concluída de forma assíncrona. A função ClfsMgmtAdvanceTailCallback não deve retornar STATUS_SUCCESS, mesmo que seja concluída de forma síncrona.

Observações

A função ClfsAdvanceTailCallback é chamada quando o gerenciamento CLFS solicita que o cliente avance sua parte final do log.

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

Se a solicitação não puder ser processada, retorne um status de erro.
Se a solicitação puder ser processada, crie e enfileira um item de trabalho para executar as ações necessárias para mover a parte final do cliente e retorne STATUS_PENDING. Para obter mais informações sobre como enfileirar um thread de trabalho, consulte System Worker Threads.

Quando um cliente chama a rotina de ClfsMgmtRegisterManagedClient para se registrar no gerenciamento CLFS, o cliente fornece um ponteiro para a função de ClfsAdvanceTailCallback e os dados personalizados que serão passados como um parâmetro para a função ClfsAdvanceTailCallback 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

CLFS_MGMT_CLIENT_REGISTRATION

ClfsAdvanceLogBase

ClfsMgmtRegisterManagedClient

ClfsMgmtTailAdvanceFailure

Compartilhar via