ClfsFlushToLsn, fonction (wdm.h)

  • Article

La routine ClfsFlushToLsn force à un stockage stable tous les enregistrements dont le numéro LSN est inférieur ou égal à un LSN spécifié.

Syntaxe

CLFSUSER_API NTSTATUS ClfsFlushToLsn(
  [in]            PVOID     pvMarshalContext,
  [in]            PCLFS_LSN plsnFlush,
  [out, optional] PCLFS_LSN plsnLastFlushed
);

Paramètres

[in] pvMarshalContext

Pointeur vers un contexte opaque associé à une zone de marshaling. L’appelant a précédemment obtenu ce pointeur en appelant ClfsCreateMarshallingArea.

[in] plsnFlush

Pointeur vers une structure CLFS_LSN . Tous les enregistrements dont le LSN est inférieur ou égal à plsnFlush sont assurés d’être forcés à un stockage stable. Si plsnFlush est égal à CLFS_LSN_NULL, tous les enregistrements dans la zone de marshaling sont forcés à un stockage stable.

[out, optional] plsnLastFlushed

Pointeur vers une structure CLFS_LSN qui reçoit le numéro LSN du plus ancien enregistrement qui n’a pas été vidé. Il s’agit du numéro LSN de l’enregistrement immédiatement après le dernier enregistrement vidé.

En cas de retour réussi, plsnLastFlushed est supérieur à la valeur fournie dans plsnFlush. Toutefois, plsnLastFlushed ne pointe pas nécessairement vers un enregistrement dans le flux. Par exemple, si tous les enregistrements du flux ont été vidés, plsnLastFlushed est le LSN qui sera affecté à l’enregistrement suivant écrit dans le flux.

Valeur retournée

ClfsFlushToLsn retourne STATUS_SUCCESS si elle réussit ; sinon, elle retourne l’un des codes d’erreur définis dans Ntstatus.h.

Remarques

Pour obtenir une explication des concepts et de la terminologie CLFS, consultez Common Log File System.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête wdm.h (include Wdm.h)
Bibliothèque Clfs.lib
DLL Clfs.sys
IRQL IRQL <= APC_LEVEL

Voir aussi

ClfsFlushBuffers