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

Estructura que se pasa a las API de presencia para filtrar los registros de presencia devueltos.

## Sintaxis

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

### Miembros

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

Matriz de tipos de dispositivo. Si este campo es null, el valor predeterminado son todos los deviceTypes posibles.

*deviceTypesCount*\
Tipo: size\_t

Tamaño de la matriz deviceTypes.

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

Lista de titleIds para filtrar el resultado. Si la entrada es un vector vacío, el valor predeterminado son todos los títulos posibles.

*titleIdsCount*\
Tipo: size\_t

Tamaño de la matriz titleIds.

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

Nivel de detalle del resultado. El valor predeterminado es XblPresenceDetailLevel::Title, que obtiene información básica en el nivel de título. Para obtener información de presencia enriquecida, establézcalo en XblPresenceDetailLevel::All

*onlineOnly*\
Tipo: bool

Si es true, la API filtrará los registros de los usuarios que estén sin conexión.

*broadcastingOnly*\
Tipo: bool

Si es true, la API filtrará los registros de los usuarios que no estén difundiendo.

## Comentarios

Si no se proporcionan los filtros, se usarán los valores predeterminados:<br /> - Devuelve registros para todos los títulos posibles en todos los dispositivos.<br /> - El valor predeterminado es XblPresenceDetailLevel::Default, que es equivalente a XblPresenceDetailLevel::Title (obtener información básica en el nivel de título).<br /> - No filtra a los usuarios que están sin conexión o difundiendo.<br />

## Argumento de

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

## Requisitos

**Encabezado:** presence\_c.h

## Consulte también

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


## Related topics

- [XblPresenceDetailLevel](/es/reference/live/xsapi-c/presence_c/enums/xblpresencedetaillevel.md)
- [XblPresenceDeviceType](/es/reference/live/xsapi-c/presence_c/enums/xblpresencedevicetype.md)
- [XblPresenceGetPresenceForMultipleUsersAsync](/es/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceformultipleusersasync.md)
- [XblPresenceGetPresenceForSocialGroupAsync](/es/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md)
- [Obtención de la presencia de un usuario](/es/services/xbox-services/community/presence/how-to/live-getting-a-users-presence.md)