PEVENT_RECORD_CALLBACK callback function

Consumers implement this callback to receive events from a session.

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

Syntax

PEVENT_RECORD_CALLBACK PeventRecordCallback;

void PeventRecordCallback(
  PEVENT_RECORD EventRecord
)
{...}

Parameters

EventRecord

Pointer to an EVENT_RECORD structure that contains the event information.

Return Value

The function does not return a value.

Remarks

To specify the function that ETW calls to deliver events, set the EventRecordCallback member of the EVENT_TRACE_LOGFILE structure (you pass this structure to the OpenTrace function). You must also set the ProcessTraceMode member to PROCESS_TRACE_MODE_EVENT_RECORD.

This callback receives all events that the session generates from the time you call the OpenTrace function. Call the ProcessTrace function to begin receiving the events.

For information on parsing the event data, see Retrieving Event Data Using TDH.

Requirements

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

See Also

BufferCallback

EVENT_TRACE_LOGFILE

ProcessTrace