Skip to main content

XblPresenceQueryFilters

Structure passée aux API de présence pour filtrer les enregistrements de présence retournés.

Syntaxe

Membres

deviceTypes
Type : const XblPresenceDeviceType*
Tableau de types d’appareils. Si ce champ est null, tous les deviceTypes possibles sont utilisés par défaut. deviceTypesCount
Type : size_t
Taille du tableau deviceTypes. titleIds
Type : const uint32_t*
Liste de titleIds servant à filtrer le résultat. Si l’entrée est un vecteur vide, tous les titres possibles sont utilisés par défaut. titleIdsCount
Type : size_t
Taille du tableau titleIds. detailLevel
Type : XblPresenceDetailLevel
Niveau de détail du résultat. La valeur par défaut est XblPresenceDetailLevel::Title, qui obtient les informations de base au niveau du titre. Pour obtenir les informations Rich Presence, définissez la valeur XblPresenceDetailLevel::All onlineOnly
Type : bool
Si la valeur est true, l’API exclut les enregistrements des utilisateurs qui sont hors ligne. broadcastingOnly
Type : bool
Si la valeur est true, l’API exclut les enregistrements des utilisateurs qui ne diffusent pas.

Remarques

Si les filtres ne sont pas fournis, les valeurs par défaut sont utilisées :
- Retourne les enregistrements pour tous les titres possibles sur tous les appareils.
- La valeur par défaut est XblPresenceDetailLevel::Default, qui équivaut à XblPresenceDetailLevel::Title (obtient les informations de base au niveau du titre).
- N’exclut pas les utilisateurs qui sont hors ligne ou qui diffusent.

Argument de

XblPresenceGetPresenceForMultipleUsersAsync
XblPresenceGetPresenceForSocialGroupAsync

Configuration requise

En-tête : presence_c.h

Voir aussi

presence_c
Last modified on October 6, 2026