PEVENT_TRACE_BUFFER_CALLBACKW Rückruffunktion (evntrace.h)
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 |