PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK fonction de rappel (wdm.h)

Article
02/07/2025

La fonction ClfsLogGrowthCompleteCallback implémente les actions que le client prendra lorsque l’espace est libéré dans un journal qui avait été rempli précédemment.

Syntaxe

PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK PclfsClientLffHandlerCompleteCallback;

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

Paramètres

[in] LogFile

Pointeur vers une structure LOG_FILE_OBJECT qui représente le flux de journal CLFS dont le journal a fini de croître.

[in] OperationStatus

État de la demande antérieure du client pour gérer une condition complète de fichier journal. Il s’agit de STATUS_SUCCESS ou d’un état d’erreur qui indique la raison pour laquelle la demande n’a pas pu être effectuée correctement.

[in] LogIsPinned

Si TRUE, spécifie que la fin du journal est actuellement épinglée ; FALSE si la fin du journal n’est pas épinglée.

[in] ClientData

Pointeur vers les informations fournies par le client.

Valeur de retour

Aucun

Remarques

Étant donné qu’un appel à ClfsMgmtHandleLogFileFull se termine de manière asynchrone, toutes les actions que le client effectuera lorsque la condition complète du fichier journal a été gérée dans la fonction ClfsLogGrowthCompleteCallback.

Si un appel à la routine ClfsMgmtHandleLogFileFull retournée retourne STATUS_PENDING, la fonction ClfsLogGrowthCompleteCallback sera appelée une fois l’opération terminée. Si un autre état a été retourné, la fonction ClfsLogGrowthCompleteCallback ne sera pas appelée.

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

Si la valeur du paramètre OperationStatus est un état d’erreur, retournez.
Si la valeur du paramètre OperationStatus est STATUS_SUCCESS, créez et mettez en file d’attente un élément de travail pour informer le client qu’il peut reprendre le traitement.

Lorsqu’un client utilise la routine ClfsMgmtRegisterManagedClient pour s’inscrire auprès de la gestion CLFS, le client fournit à la fois un pointeur vers la fonction ClfsLogGrowthCompleteCallback et les données personnalisées qui seront transmises en tant que paramètre à la fonction ClfsLogGrowthCompleteCallback 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

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient

Partager via