WppRecorderLogCreate, macro (wpprecorder.h)

Article
02/27/2024

La méthode WppRecorderLogCreate crée une mémoire tampon pour contenir le journal de l’enregistreur.

Syntaxe

__drv_maxIRQL(DISPATCH_LEVEL)
NTSTATUS WppRecorderLogCreate(
    [In]        PRECORDER_LOG_CREATE_PARAMS CreateParams,
    [Out]       RECORDER_LOG *              RecorderLog
    );

Paramètres

[in] CreateParams

Pointeur vers une structure RECORDER_LOG_CREATE_PARAMS .

[out] RecorderLog

Handle pour le journal de l’enregistreur.

Valeur de retour

None

Remarques

Retourne NTSTATUS qui indique si le pilote peut utiliser le handle RecorderLog pour la journalisation.

Avant d’appeler WppRecorderLogCreate, allouez une structure RECORDER_LOG_CREATE_PARAMS et initialisez en appelant RECORDER_LOG_CREATE_PARAMS_INIT.

Vous devez d’abord appeler WPP_INIT_TRACING avant d’appeler WppRecorderLogCreate. Les valeurs par défaut sont utilisées, sauf si les membres de CreateParams sont modifiés avant d’appeler WppRecorderLogCreate.

Si un NTSTATUS réussi est retourné, le pilote peut utiliser le handle RecorderLog pour la journalisation.

Si un NTSTATUS réussi n’est pas retourné, le pilote doit utiliser un handle de RECORDER_LOG pour le journal par défaut. En outre, le pilote ne doit pas tenter de se connecter à ou de supprimer le handle pointé par RecorderLog.

Notes

Cette méthode alloue de la mémoire pour la mémoire tampon du journal à partir du pool non paginé.

Exemple

RECORDER_LOG_CREATE_PARAMS  recorderCreate; 
RECORDER_LOG                logHandle;
 
RECORDER_LOG_CREATE_PARAMS_INIT(&recorderCreate, "Log #1");
recorderCreate.TotalBufferSize = 1024 * 8;
// Optionally use the following line to get timestamps in WPP log entries
recorderCreate.UseTimeStamp    = WppRecorderTrue;
// Use this line if you would like more precise timestamps (ten millionths of a second). This is valid only if you have set UseTimeStamp = WppRecorderTrue.
// recorderCreate.PreciseTimeStamp = WppRecorderTrue
status = WppRecorderLogCreate(&recorderCreate, &logHandle);

Pour plus d’informations sur les horodatages dans les entrées de journal WPP, y compris l’exemple de sortie du journal, consultez Enregistreur de traces en clair (IFR) pour la journalisation des traces.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	wpprecorder.h

Voir aussi

RECORDER_LOG_CREATE_PARAMS structure

Partager via