ClfsReadNextLogRecord, fonction (wdm.h)

Article
02/07/2025

Le ClfsReadNextLogRecord routine lit l’enregistrement suivant dans une séquence, par rapport à l’enregistrement actif dans un contexte de lecture.

Syntaxe

CLFSUSER_API NTSTATUS ClfsReadNextLogRecord(
  [in, out]      PVOID             pvReadContext,
  [out]          PVOID             *ppvBuffer,
  [out]          PULONG            pcbBuffer,
  [in, out]      PCLFS_RECORD_TYPE peRecordType,
  [in, optional] PCLFS_LSN         plsnUser,
  [out]          PCLFS_LSN         plsnUndoNext,
  [out]          PCLFS_LSN         plsnPrevious,
  [out]          PCLFS_LSN         plsnRecord
);

Paramètres

[in, out] pvReadContext

Pointeur vers un contexte de lecture que l’appelant a obtenu précédemment en appelant ClfsReadLogRecord ou ClfsReadRestartArea.

[out] ppvBuffer

Pointeur vers une variable qui reçoit un pointeur vers une mémoire tampon qui contient les données d’enregistrement.

[out] pcbBuffer

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

[in, out] peRecordType

Pointeur vers une variable de type CLFS_RECORD_TYPE. L’appelant doit définir ce paramètre sur l’une des valeurs suivantes.

Valeur	Enregistrement qui sera lu
ClfsDataRecord	Enregistrement de données suivant.
ClfsRestartRecord	Enregistrement de redémarrage suivant.
ClfsClientRecord	Enregistrement suivant qui est un enregistrement de données ou un enregistrement de redémarrage.

[in, optional] plsnUser

Pointeur vers une structure CLFS_LSN qui fournit le LSN de l’enregistrement à lire. L’enregistrement spécifié est lu au lieu de l’enregistrement qui aurait été lu conformément au mode (ClfsContextUndoNext, ClfsContextPrevious, ou ClfsContextForward) du contexte de lecture (pvReadContext). Le LSN fourni dans plsnUser doit être inférieur au LSN actuel du contexte de lecture. Ce paramètre peut être NULL.

[out] plsnUndoNext

Pointeur vers une structure CLFS_LSN qui reçoit l’undo-next LSN de l’enregistrement lu.

[out] plsnPrevious

Pointeur vers une structure CLFS_LSN qui reçoit le LSN précédent de l’enregistrement lu.

[out] plsnRecord

Pointeur vers une structure CLFS_LSN qui reçoit le LSN de l’enregistrement lu.

Valeur de retour

ClfsReadNextLogRecord 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 flux CLFS et lecture d’enregistrements de redémarrage à partir d’un flux 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible 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)
bibliothèque	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Voir aussi

CLFS_LSN

ClfsReadLogRecord

ClfsReadRestartArea

Partager via