XGameEventWrite
写入一个游戏内事件,该事件可选择性地包含“维度”和“度量”数据字段。Syntax
Parameters
user _In_类型:XUserHandle 代表其发送事件的用户句柄。 *serviceConfigId _In_z_
类型:char 此标题的 XBOX Live 服务配置 ID (SCID)。 *playSessionId _In_z_
类型:char 玩耍会话 ID。这是游戏在每个游戏会话开始时创建的唯一 GUID,用于跟踪在单个玩耍会话中发送的事件集。 eventName _In_z_
类型:char* 事件名称。 dimensionsJson _In_opt_z_
类型:char* JSON 格式的维度数据字段。 measurementsJson _In_opt_z_
类型:char* JSON 格式的度量数据字段。
Return value
类型:HRESULT 如果成功,则返回 S_OK;否则返回错误代码。有关错误代码的列表,请参阅错误代码。Remarks
此函数在时间敏感型线程上调用是不安全的。有关详细信息,请参阅时间敏感型线程。
度量只能具有数值,而维度可以具有更多类型的值。如果需要,可以完全使用 dimensionsJson 字段来写入事件。
