BufferCallback 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


ULONG WINAPI BufferCallback(
  _In_  PEVENT_TRACE_LOGFILE Buffer
);

Parameters

Buffer [in]

Pointer to an EVENT_TRACE_LOGFILE structure that contains information about the buffer.

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]

Header

Evntrace.h

See also

EVENT_TRACE_LOGFILE
ProcessTrace

 

 

Community Additions

ADD
Show:
© 2014 Microsoft