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 |