> ## 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

Struct passed to presence APIs to filter the presence records returned.

## Syntax

```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  
```

### Members

*deviceTypes*\
Type: const [XblPresenceDeviceType\*](/reference/live/xsapi-c/presence_c/enums/xblpresencedevicetype)

Array of device types. If this field is null, defaults to all possible deviceTypes.

*deviceTypesCount*\
Type: size\_t

Size of the deviceTypes array.

*titleIds*\
Type: const uint32\_t\*

List of titleIds for filtering the result. If the input is an empty vector, defaults to all possible titles.

*titleIdsCount*\
Type: size\_t

Size of the titleIds array.

*detailLevel*\
Type: [XblPresenceDetailLevel](/reference/live/xsapi-c/presence_c/enums/xblpresencedetaillevel)

Detail level of the result. Defaults to XblPresenceDetailLevel::Title which get basic title level information. To get rich presence info, set to XblPresenceDetailLevel::All

*onlineOnly*\
Type: bool

If true, API will filter out records for users that are offline.

*broadcastingOnly*\
Type: bool

If true, API will filter out records for users that are not broadcasting.

## Remarks

If the filters are not provided, defaults will be used:<br /> - Returns records for all possible titles on all devices.<br /> - Defaults to XblPresenceDetailLevel::Default which is equivalent to XblPresenceDetailLevel::Title (get basic title level information).<br /> - Does not filter out users who are offline or broadcasting.<br />

## Argument of

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

## Requirements

**Header:** presence\_c.h

## See also

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


## Related topics

- [XblPresenceDetailLevel](/reference/live/xsapi-c/presence_c/enums/xblpresencedetaillevel.md)
- [XblPresenceDeviceType](/reference/live/xsapi-c/presence_c/enums/xblpresencedevicetype.md)
- [XblPresenceGetPresenceForMultipleUsersAsync](/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceformultipleusersasync.md)
- [Getting a user's Presence](/services/xbox-services/community/presence/how-to/live-getting-a-users-presence.md)
- [XblPresenceGetPresenceForSocialGroupAsync](/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md)