> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblPresenceQueryFilters

> XblPresenceQueryFilters

# XblPresenceQueryFilters

传递给状态 API 的结构，用于筛选返回的状态记录。

## 语法

```cpp theme={null}
typedef struct XblPresenceQueryFilters {  
    const XblPresenceDeviceType* deviceTypes;  
    size_t deviceTypesCount;  
    const uint32_t* titleIds;  
    size_t titleIdsCount;  
    XblPresenceDetailLevel detailLevel;  
    bool onlineOnly;  
    bool broadcastingOnly;  
} XblPresenceQueryFilters  
```

### 成员

*deviceTypes*\
类型：const [XblPresenceDeviceType\*](/reference/live/xsapi-c/presence_c/enums/xblpresencedevicetype)

设备类型数组。如果此字段为 null，则默认为所有可能的 deviceTypes。

*deviceTypesCount*\
类型：size\_t

deviceTypes 数组的大小。

*titleIds*\
类型：const uint32\_t\*

用于筛选结果的 titleId 列表。如果输入为空向量，则默认为所有可能的标题。

*titleIdsCount*\
类型：size\_t

titleIds 数组的大小。

*detailLevel*\
类型：[XblPresenceDetailLevel](/reference/live/xsapi-c/presence_c/enums/xblpresencedetaillevel)

结果的详细信息级别。默认为 XblPresenceDetailLevel::Title，获取基本的标题级别信息。若要获取丰富状态信息，请设置为 XblPresenceDetailLevel::All

*onlineOnly*\
类型：bool

如果为 true，API 将筛选掉处于离线状态的用户记录。

*broadcastingOnly*\
类型：bool

如果为 true，API 将筛选掉未在进行广播的用户记录。

## 备注

如果未提供筛选器，将使用默认值：<br /> - 返回所有设备上所有可能标题的记录。<br /> - 默认为 XblPresenceDetailLevel::Default，等同于 XblPresenceDetailLevel::Title（获取基本的标题级别信息）。<br /> - 不筛选掉处于离线状态或正在广播的用户。<br />

## 用作参数

[XblPresenceGetPresenceForMultipleUsersAsync](/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceformultipleusersasync)\
[XblPresenceGetPresenceForSocialGroupAsync](/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync)

## 要求

**头文件：** presence\_c.h

## 另请参阅

[presence\_c](/reference/live/xsapi-c/presence_c/presence_c_members)


## Related topics

- [XblPresenceDetailLevel](/zh-CN/reference/live/xsapi-c/presence_c/enums/xblpresencedetaillevel.md)
- [XblPresenceDeviceType](/zh-CN/reference/live/xsapi-c/presence_c/enums/xblpresencedevicetype.md)
- [XblPresenceGetPresenceForMultipleUsersAsync](/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceformultipleusersasync.md)
- [获取用户的 Presence](/zh-CN/services/xbox-services/community/presence/how-to/live-getting-a-users-presence.md)
- [XblPresenceGetPresenceForSocialGroupAsync](/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md)