PCLFS_CLIENT_LFF_HANDLER_COMPLETE_CALLBACK fonction de rappel (wdm.h)

Article
02/27/2024

La fonction ClfsLogGrowthCompleteCallback implémente les actions que le client effectuera lorsque l’espace est libéré dans un journal qui était auparavant plein.

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 de LOG_FILE_OBJECT qui représente le flux de journal CLFS dont le journal a fini de croître.

[in] OperationStatus

Le status de la demande précédente du client pour gérer une condition complète de fichier journal. Il s’agit d’une STATUS_SUCCESS ou d’une erreur status qui indique la raison pour laquelle la demande n’a pas pu être exécutée correctement.

[in] LogIsPinned

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

[in] ClientData

Pointeur vers les informations fournies par le client.

Valeur de retour

None

Remarques

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

Si un appel à la routine ClfsMgmtHandleLogFileFull retourné retourne STATUS_PENDING, la fonction ClfsLogGrowthCompleteCallback est appelée une fois l’opération terminée. Si une autre status a été retournée, la fonction ClfsLogGrowthCompleteCallback n’est 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 une erreur status, 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 passées en tant que paramètre à la fonction ClfsLogGrowthCompleteCallback lorsque cette fonction est appelée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans Windows Server 2003 R2, Windows Vista et les versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
IRQL	Appelé à IRQL <= APC_LEVEL

Voir aussi

ClfsMgmtHandleLogFileFull

ClfsMgmtRegisterManagedClient

Partager via