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

  • Artigo

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

Sintaxe

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 LOG_FILE_OBJECT que representa o fluxo de log CLFS cuja cauda deve ser avançada.

[in] TargetLsn

Um ponteiro para uma estrutura 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 .

Retornar valor

A função ClfsAdvanceTailCallback deve retornar STATUS_PENDING ou um erro status. 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.

Comentários

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

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

  1. Se a solicitação não puder ser processada, retorne um erro status.
  2. 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, em seguida, 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 ClfsMgmtRegisterManagedClient para se registrar no gerenciamento CLFS, o cliente fornece um ponteiro para a função 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
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

CLFS_MGMT_CLIENT_REGISTRATION

ClfsAdvanceLogBase

ClfsMgmtRegisterManagedClient

ClfsMgmtTailAdvanceFailure