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 |