WppRecorderLogCreate-Makro (wpprecorder.h)

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

Keine

Bemerkungen

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

Ordnen Sie vor dem Aufrufen von WppRecorderLogCreate eine RECORDER_LOG_CREATE_PARAMS-Struktur zu, und initialisieren Sie , indem Sie RECORDER_LOG_CREATE_PARAMS_INIT aufrufen.

Sie müssen zuerst WPP_INIT_TRACING aufrufen, bevor Sie WppRecorderLogCreate aufrufen. Standardwerte werden verwendet, es sei denn, die Member von CreateParams werden vor dem Aufrufen von WppRecorderLogCreate geä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, das Handle zu protokollieren oder zu löschen, auf das recorderLog verweist.

Hinweis

Diese Methode ordnet Arbeitsspeicher für den Protokollpuffer aus dem Nicht-Auslagerungspool 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	Windows
Kopfzeile	wpprecorder.h

Weitere Informationen

RECORDER_LOG_CREATE_PARAMS-Struktur