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

Structure transmise aux API de présence pour filtrer les enregistrements de présence renvoyés.

## Syntaxe

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

### Membres

*deviceTypes*\
Type : const [XblPresenceDeviceType\*](/fr/reference/live/xsapi-c/presence_c/enums/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 permettant de 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](/fr/reference/live/xsapi-c/presence_c/enums/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 cette valeur sur XblPresenceDetailLevel::All

*onlineOnly*\
Type : bool

Si la valeur est true, l'API exclut les enregistrements des utilisateurs 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 :<br /> - Renvoie les enregistrements pour tous les titres possibles sur tous les appareils.<br /> - Utilise par défaut XblPresenceDetailLevel::Default, qui équivaut à XblPresenceDetailLevel::Title (obtient les informations de base au niveau du titre).<br /> - N'exclut pas les utilisateurs hors ligne ou en cours de diffusion.<br />

## Argument de

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

## Configuration requise

**En-tête :** presence\_c.h

## Voir aussi

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


## Related topics

- [XblPresenceQueryFilters](/reference/live/xsapi-c/presence_c/structs/xblpresencequeryfilters.md)
- [XblPresenceDetailLevel](/reference/live/xsapi-c/presence_c/enums/xblpresencedetaillevel.md)