PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK fonction de rappel (wdm.h)

Article
02/07/2025

La fonction ClfsAdvanceTailCallback avance le numéro de séquence de journal de base (LSN) du journal du client.

Syntaxe

PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK PclfsClientAdvanceTailCallback;

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

Paramètres

[in] LogFile

Pointeur vers une structure LOG_FILE_OBJECT qui représente le flux de journal CLFS dont la fin doit être avancée.

[in] TargetLsn

Pointeur vers une structure CLFS_LSN qui contient le LSN que le client doit avancer vers ou au-delà.

[in] ClientData

Pointeur vers les informations fournies par le client. Vous spécifiez ces données dans le membre AdvanceTailCallbackData de la structure CLFS_MGMT_CLIENT_REGISTRATION.

Valeur de retour

La fonction ClfsAdvanceTailCallback doit retourner STATUS_PENDING ou un état d’erreur. Une valeur de retour de STATUS_PENDING indique que la demande de déplacement de la fin du journal du client est terminée de manière asynchrone. La fonction ClfsMgmtAdvanceTailCallback ne doit pas retourner STATUS_SUCCESS, même si elle se termine de façon synchrone.

Remarques

La fonction ClfsAdvanceTailCallback est appelée lorsque la gestion CLFS demande au client d’avancer sa fin de journal.

La fonction ClfsAdvanceTailCallback ne doit effectuer qu’une quantité minimale de traitement avant de retourner. Par exemple, la fonction ClfsAdvanceTailCallback peut suivre cette procédure :

Si la demande ne peut pas être traitée, retournez un état d’erreur.
Si la demande peut être traitée, créez et mettez en file d’attente un élément de travail pour effectuer les actions requises pour déplacer la queue du client, puis retournez STATUS_PENDING. Pour plus d’informations sur la mise en file d’attente d’un thread de travail, consultez threads de travail système.

Lorsqu’un client appelle la routine ClfsMgmtRegisterManagedClient pour s’inscrire auprès de la gestion CLFS, le client fournit à la fois un pointeur vers la fonction ClfsAdvanceTailCallback et les données personnalisées qui seront transmises en tant que paramètre à la fonction ClfsAdvanceTailCallback lorsque cette fonction est appelée.

Exigences

Exigence	Valeur
client minimum pris en charge	Pris en charge dans Windows Server 2003 R2, Windows Vista et versions ultérieures de Windows.
plateforme cible	Bureau
d’en-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL	Appelé au <IRQL = APC_LEVEL

Voir aussi

CLFS_MGMT_CLIENT_REGISTRATION

ClfsAdvanceLogBase

ClfsMgmtRegisterManagedClient

ClfsMgmtTailAdvanceFailure

Partager via