PETW_BUFFER_CALLBACK Rückruffunktion (evntrace.h)

  • Artikel

Funktionsdefinition für den BufferCallback, der von ProcessTrace aufgerufen wird.

Syntax

PETW_BUFFER_CALLBACK PetwBufferCallback;

BOOL PetwBufferCallback(
  const ETW_BUFFER_HEADER *Buffer,
  ULONG BufferSize,
  const ETW_BUFFER_CALLBACK_INFORMATION *ConsumerInfo,
  void *CallbackContext
)
{...}

Parameter

Buffer

Zeiger auf die Rohdaten des Puffers, der mit einer ETW_BUFFER_HEADER Struktur beginnt, gefolgt von Ereignisdaten.

Standardmäßig ist dieser Puffer nur verfügbar, bis der Rückruf zurückgibt. Um den Puffer nach dem Rückruf zu verwenden, rufen Sie ProcessTraceBufferIncrementReference auf. Dadurch bleibt der Puffer verfügbar, bis Sie ProcessTraceBufferDecrementReference darauf aufrufen.

ProcessTrace wird erst zurückgegeben, wenn alle Pufferverweise dekrementiert wurden.

BufferSize

Größe des bereitgestellten Puffers.

ConsumerInfo

Enthält Informationen zum aktuellen Zustand der Verarbeitungssitzung.

CallbackContext

Vom Benutzer bereitgestellter Kontext aus ETW_OPEN_TRACE_OPTIONS. BufferCallbackContext.

Rückgabewert

Bei TRUE wird die Verarbeitung fortgesetzt. Bei FALSE wird die Ablaufverfolgungsverarbeitung beendet, und ProcessTrace wird zurückgegeben.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile evntrace.h
Bibliothek Sechost.lib unter Windows 8.1 und Windows Server 2012 R2; Advapi32.lib unter Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista und Windows XP
DLL Sechost.dll unter Windows 8.1 und Windows Server 2012 R2; Advapi32.dll unter Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista und Windows XP