WppRecorderLogCreate-Makro (wpprecorder.h)

Artikel
02/07/2025

Die WppRecorderLogCreate-Methode erstellt einen Puffer, der das Aufzeichnungsprotokoll enthält.

Syntax

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

Parameter

[in] CreateParams

Ein Zeiger auf eine RECORDER_LOG_CREATE_PARAMS Struktur.

[out] RecorderLog

Ein Handle für das Aufzeichnungsprotokoll.

Rückgabewert

Nichts

Bemerkungen

Gibt NTSTATUS zurück, der angibt, ob der Treiber das RecorderLog Handle für die Protokollierung verwenden kann.

Bevor Sie WppRecorderLogCreateaufrufen, weisen Sie eine RECORDER_LOG_CREATE_PARAMS Struktur zu und initialisieren Sie durch Aufrufen von RECORDER_LOG_CREATE_PARAMS_INIT.

Sie müssen zuerst WPP_INIT_TRACING aufrufen, bevor Sie WppRecorderLogCreateaufrufen. Standardwerte werden verwendet, es sei denn, die Member von CreateParams werden vor dem Aufrufen WppRecorderLogCreategeändert.

Wenn ein erfolgreicher NTSTATUS zurückgegeben wird, kann der Treiber das RecorderLog- Handle für die Protokollierung verwenden.

Wenn kein erfolgreicher NTSTATUS zurückgegeben wird, muss der Treiber ein RECORDER_LOG Handle für das Standardprotokoll verwenden. Außerdem darf der Treiber nicht versuchen, den handle zu protokollieren oder zu löschen, auf den RecorderLogverweist.

Anmerkung

Diese Methode weist speicher für den Protokollpuffer aus dem nicht ausgelagerten Pool zu.

Beispiel

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);

Weitere Informationen zu Zeitstempeln in WPP-Protokolleinträgen einschließlich Beispielprotokollausgabe finden Sie unter Inflight Trace Recorder (IFR) für die Protokollierung von Ablaufverfolgungen.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	wpprecorder.h

Siehe auch

RECORDER_LOG_CREATE_PARAMS Struktur

Freigeben über