Skip to main content

XblPresenceQueryFilters

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

Syntax

Members

deviceTypes
Type: const 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
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:
- Returns records for all possible titles on all devices.
- Defaults to XblPresenceDetailLevel::Default which is equivalent to XblPresenceDetailLevel::Title (get basic title level information).
- Does not filter out users who are offline or broadcasting.

Argument of

XblPresenceGetPresenceForMultipleUsersAsync
XblPresenceGetPresenceForSocialGroupAsync

Requirements

Header: presence_c.h

See also

presence_c
Last modified on August 4, 2026