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

另请参阅

multiplayer_c