XblMultiplayerSessionQuery
根据此请求的配置查询可见的多人游戏会话。
语法
typedef struct XblMultiplayerSessionQuery {
char Scid[XBL_SCID_LENGTH];
uint32_t MaxItems;
bool IncludePrivateSessions;
bool IncludeReservations;
bool IncludeInactiveSessions;
uint64_t* XuidFilters;
size_t XuidFiltersCount;
const char* KeywordFilter;
char SessionTemplateNameFilter[XBL_MULTIPLAYER_SESSION_TEMPLATE_NAME_MAX_LENGTH];
XblMultiplayerSessionVisibility VisibilityFilter;
uint32_t ContractVersionFilter;
} XblMultiplayerSessionQuery
成员
Scid
类型:char[XBL_SCID_LENGTH]
会话所属于的服务配置 ID。
MaxItems
类型:uint32_t
要返回的最多项目数。
IncludePrivateSessions
类型:bool
在结果中包括专用会话。
IncludeReservations
类型:bool
包括用户尚未接受的会话。 必须指定要使用的 xboxUserIdFilter。
IncludeInactiveSessions
类型:bool
在结果中包括非活动会话。 必须指定要使用的 xboxUserIdFilter。
XuidFilters
类型:uint64_t*
将结果筛选为只包含这些 Xbox 用户 ID 所属的会话。 (可选)必须指定至少一个 Xuid 筛选器或关键字筛选器。
XuidFiltersCount
类型:size_t
XuidsFilters 数组中的 Xuids 数量。
KeywordFilter
类型:const char*
将结果筛选为仅具有此关键字的会话。 (可选)必须指定至少一个 Xuid 筛选器或关键字筛选器。
SessionTemplateNameFilter
类型:char[XBL_MULTIPLAYER_SESSION_TEMPLATE_NAME_MAX_LENGTH]
筛选多人游戏会话所基于的模板的名称。
VisibilityFilter
类型:XblMultiplayerSessionVisibility
将结果筛选为仅具有指定可见性的会话。
ContractVersionFilter
类型:uint32_t
将结果筛选为只包含合同的这一主要版本或更低版本的会话。 用 0 来忽略。
要求
头文件:multiplayer_c.h