PEVENT_TRACE_BUFFER_CALLBACKA callback function

Consumers implement this function to receive statistics about each buffer of events that ETW delivers to an event trace consumer. ETW calls this function after the events for each buffer are delivered.

The PEVENT_TRACE_BUFFER_CALLBACK type defines a pointer to this callback function. BufferCallback is a placeholder for the application-defined function name.

Syntax

PEVENT_TRACE_BUFFER_CALLBACKA PeventTraceBufferCallbacka;

ULONG PeventTraceBufferCallbacka(
  PEVENT_TRACE_LOGFILEA Logfile
)
{...}

Parameters

Logfile

Return Value

To continue processing events, return TRUE. Otherwise, return FALSE. Returning FALSE will terminate the ProcessTrace function.

Remarks

To specify the function that ETW calls to deliver the buffer statistics, set the BufferCallback member of the EVENT_TRACE_LOGFILE structure that you pass to the OpenTrace function.

Examples

For an example implementation of a BufferCallback function, see Retrieving Event Data Using MOF.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header evntrace.h

See Also

EVENT_TRACE_LOGFILE

ProcessTrace