XblEventsWriteInGameEvent
Write an in-game event that includes "dimensions" and "measurement" data fields.
Syntax
HRESULT XblEventsWriteInGameEvent(
XblContextHandle xboxLiveContext,
const char* eventName,
const char* dimensionsJson,
const char* measurementsJson
)
Parameters
xboxLiveContext _In_
Type: XblContextHandle
Xbox Live context handle.
eventName _In_z_
Type: char*
Event name. Must be contain only alphanumeric characters.
dimensionsJson _In_opt_z_
Type: char*
Dimensions data fields.
measurementsJson _In_opt_z_
Type: char*
Measurement data fields.
Return value
Type: HRESULT
HRESULT return code for this API operation.
Remarks
Dimensions include event fields with a finite number of defined numeric or string values. Examples of dimensions: map id, difficulty level, character or weapon class, game mode, boolean settings, etc. Measurements include event fields that represent scalar numeric metrics. Examples of measurements: score, time, counters, position, etc. Example: for an in-game event that tracks the highest match score for a particular difficulty level: The difficulty level should be included in dimensions, and the score should be included in measurements. The name of the event, and the names of the event fields (both dimensions and measurements), must match the names declared in the title's service configuration. The names are case insensitive. If the API writes an event with a name that does not match a name in the service configuration, the service drops the event with no notification. When using the GDK PC version, a GRTS runtime with the XGameEvent feature must be installed or this will E_NOTIMPL.
Requirements
Header: events_c.h
Library: Microsoft.Xbox.Services.14x.GDK.C.lib