PEVENT_TRACE_BUFFER_CALLBACKW Rückruffunktion (evntrace.h)

  • Artikel

ETW-Ereignisverbraucher implementieren diese Funktion, um Statistiken zu jedem Puffer von Ereignissen zu erhalten, die ETW während einer Ablaufverfolgungsverarbeitungssitzung liefert. ETW ruft diese Funktion auf, nachdem die Ereignisse für jeden Puffer übermittelt wurden.

Der PEVENT_TRACE_BUFFER_CALLBACK-Typ definiert einen Zeiger auf diese Rückruffunktion. BufferCallback ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

PEVENT_TRACE_BUFFER_CALLBACKW PeventTraceBufferCallbackw;

ULONG PeventTraceBufferCallbackw(
  PEVENT_TRACE_LOGFILEW Logfile
)
{...}

Parameter

Logfile

Zeiger auf eine EVENT_TRACE_LOGFILE-Struktur , die Informationen zum Puffer enthält.

Rückgabewert

Um die Verarbeitung von Ereignissen fortzusetzen, geben Sie TRUE zurück. Andernfalls geben Sie FALSE zurück. Wenn Sie FALSE zurückgeben, wird die ProcessTrace-Funktion beendet.

Hinweise

Um die Funktion anzugeben, die ETW aufruft, um die Pufferstatistik bereitzustellen, legen Sie das BufferCallback-Element der EVENT_TRACE_LOGFILE-Struktur fest, die Sie an die OpenTrace-Funktion übergeben.

Beispiele

Eine Beispielimplementierung einer BufferCallback-Funktion finden Sie unter Abrufen von Ereignisdaten mithilfe von MOF.

Hinweis

Der evntrace.h-Header definiert PEVENT_TRACE_BUFFER_CALLBACK als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile evntrace.h

Weitere Informationen

EVENT_TRACE_LOGFILE

OpenTrace

ProcessTrace