Skip to main content

XblPresenceQueryFilters

Struct passada para as APIs de presença para filtrar os registros de presença retornados.

Sintaxe

Membros

deviceTypes
Tipo: const 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
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
XblPresenceGetPresenceForSocialGroupAsync

Requisitos

Cabeçalho: presence_c.h

Confira também

presence_c
Last modified on October 6, 2026