EventDescCreate function (evntprov.h)

Sets the values of an event descriptor.

Syntax

EVNTPROV_PFORCEINLINE VOID EventDescCreate(
  [out] PEVENT_DESCRIPTOR EventDescriptor,
  [in]  USHORT            Id,
  [in]  UCHAR             Version,
  [in]  UCHAR             Channel,
  [in]  UCHAR             Level,
  [in]  USHORT            Task,
  [in]  UCHAR             Opcode,
  [in]  ULONGLONG         Keyword
);

Parameters

[out] EventDescriptor

Event descriptor whose member values are set to those of the remaining parameters. For details, see EVENT_DESCRIPTOR.

[in] Id

Event identifier. The value is used to set the Id member of EVENT_DESCRIPTOR.

[in] Version

Version of the event. The value is used to set the Version member of EVENT_DESCRIPTOR.

[in] Channel

The category of events to which this event belongs. The value is used to set the Channel member of EVENT_DESCRIPTOR.

[in] Level

Specifies the severity of the event. The value is used to set the Level member of EVENT_DESCRIPTOR.

[in] Task

Identifies a logical component of the application whose events you want to enable. The value is used to set the Task member of EVENT_DESCRIPTOR.

[in] Opcode

Operation being performed at the time the event was written. The value is used to set the Opcode member of EVENT_DESCRIPTOR.

[in] Keyword

Bitmask that further defines the category of events to which the event belongs. The value is used to set the Keyword member of EVENT_DESCRIPTOR.

Return value

This function does not return a value.

Remarks

This is a convenience macro for setting the members of the EVENT_DESCRIPTOR structure.

Requirements

See also

EventDescZero