> ## 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 passada para as APIs de presença para filtrar os registros de presença retornados.

## Sintaxe

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

### Membros

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

Matriz de tipos de dispositivo. Se este campo for nulo, o padrão será todos os deviceTypes possíveis.

*deviceTypesCount*\
Tipo: size\_t

Tamanho da matriz deviceTypes.

*titleIds*\
Tipo: const uint32\_t\*

Lista de titleIds para filtrar o resultado. Se a entrada for um vetor vazio, o padrão será todos os títulos possíveis.

*titleIdsCount*\
Tipo: size\_t

Tamanho da matriz titleIds.

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

Nível de detalhes do resultado. O padrão é XblPresenceDetailLevel::Title, que obtém informações básicas no nível do título. Para obter informações do Rich Presence, defina como XblPresenceDetailLevel::All

*onlineOnly*\
Tipo: bool

Se for true, a API filtrará os registros de usuários que estão offline.

*broadcastingOnly*\
Tipo: bool

Se for true, a API filtrará os registros de usuários que não estão transmitindo.

## Comentários

Se os filtros não forem fornecidos, os padrões serão usados:<br /> - Retorna registros para todos os títulos possíveis em todos os dispositivos.<br /> - O padrão é XblPresenceDetailLevel::Default, que equivale a XblPresenceDetailLevel::Title (obtém informações básicas no nível do título).<br /> - Não filtra usuários que estão offline ou transmitindo.<br />

## Argumento de

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

## Requisitos

**Cabeçalho:** presence\_c.h

## Confira também

[presence\_c](/pt-BR/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)