ClfsReadRestartArea, fonction (wdm.h)

  • Article

La routine ClfsReadRestartArea lit l’enregistrement de redémarrage qui a été écrit le plus récemment dans un flux CLFS spécifié.

Syntaxe

CLFSUSER_API NTSTATUS ClfsReadRestartArea(
  [in, out] PVOID     pvMarshalContext,
  [out]     PVOID     *ppvRestartBuffer,
  [out]     PULONG    pcbRestartBuffer,
  [out]     PCLFS_LSN plsn,
  [out]     PVOID     *ppvReadContext
);

Paramètres

[in, out] pvMarshalContext

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

[out] ppvRestartBuffer

Pointeur vers une variable qui reçoit un pointeur vers la mémoire tampon de données de l’enregistrement de redémarrage.

[out] pcbRestartBuffer

Pointeur vers une variable de type ULONG qui reçoit la taille, en octets, de la mémoire tampon de données pointée par pcbRestartBuffer. Il s’agit de la longueur de la mémoire tampon de données de l’enregistrement de redémarrage.

[out] plsn

Pointeur vers une structure CLFS_LSN qui reçoit le numéro LSN de l’enregistrement de redémarrage lu.

[out] ppvReadContext

Pointeur vers une variable qui reçoit un pointeur vers un contexte de lecture opaque. L’appelant peut passer ce contexte à ClfsReadPreviousRestartArea ou ClfsReadNextLogRecord. Lorsque l’appelant a fini d’utiliser le contexte de lecture, il doit libérer le contexte en appelant ClfsTerminateReadLog.

Valeur retournée

ClfsReadRestartArea 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.

Pour plus d’informations sur la lecture d’enregistrements à partir de flux CLFS, consultez Lecture d’enregistrements de données à partir d’un Stream CLFS et Lecture des enregistrements de redémarrage à partir d’un Stream CLFS.

Les contextes de lecture ne sont pas thread-safe. Les clients sont responsables de la sérialisation de l’accès aux contextes de lecture.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Server 2003 R2, Windows Vista et versions ultérieures de Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête wdm.h (include Wdm.h)
Bibliothèque Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Voir aussi

ClfsCreateMarshallingArea

ClfsReadNextLogRecord

ClfsReadPreviousRestartArea

ClfsTerminateReadLog