PEVENT_TRACE_BUFFER_CALLBACKA Rückruffunktion (evntrace.h)

ETW-Ereignisconsumer implementieren diese Funktion, um Statistiken zu jedem Ereignispuffer zu erhalten, den ETW während einer Ablaufverfolgungsverarbeitungssitzung übermittelt. 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_CALLBACKA PeventTraceBufferCallbacka;

ULONG PeventTraceBufferCallbacka(
  PEVENT_TRACE_LOGFILEA 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 wird FALSE zurückgegeben. Wenn False zurückgegeben wird, wird die ProcessTrace-Funktion beendet.

Hinweise

Um die Funktion anzugeben, die ETW aufruft, um die Pufferstatistiken zu übermitteln, legen Sie den BufferCallback-Member 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 Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

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