> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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\*](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/enums/xblpresencedevicetype.md)

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](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/enums/xblpresencedetaillevel.md)

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:\
 \- Retorna registros para todos os títulos possíveis em todos os dispositivos.\
 \- O padrão é XblPresenceDetailLevel::Default, que equivale a XblPresenceDetailLevel::Title (obtém informações básicas no nível do título).\
 \- Não filtra usuários que estão offline ou transmitindo.\


## Argumento de

[XblPresenceGetPresenceForMultipleUsersAsync](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceformultipleusersasync.md)\
[XblPresenceGetPresenceForSocialGroupAsync](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md)

## Requisitos

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

## Confira também

[presence\_c](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/presence_c_members.md)


## Related topics

- [XblPresenceDetailLevel](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/enums/xblpresencedetaillevel.md)
- [XblPresenceDeviceType](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/enums/xblpresencedevicetype.md)
- [XblPresenceGetPresenceForMultipleUsersAsync](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceformultipleusersasync.md)
- [presence_c](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/presence_c_members.md)
- [XblPresenceGetPresenceForSocialGroupAsync](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md)