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

VOID WINAPI EventRecordCallback(
  _In_ PEVENT_RECORD EventRecord
);

Parameters

EventRecord [in]

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]
Header
Evntrace.h

See also

BufferCallback

EVENT_TRACE_LOGFILE

ProcessTrace