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

반환되는 현재 상태 레코드를 필터링하기 위해 현재 상태 API에 전달되는 구조체입니다.

## Syntax

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

### Members

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

디바이스 유형의 배열입니다. 이 필드가 null이면 가능한 모든 deviceTypes로 기본 설정됩니다.

*deviceTypesCount*\
Type: size\_t

deviceTypes 배열의 크기입니다.

*titleIds*\
Type: const uint32\_t\*

결과를 필터링하기 위한 titleIds 목록입니다. 입력이 빈 벡터이면 가능한 모든 타이틀로 기본 설정됩니다.

*titleIdsCount*\
Type: size\_t

titleIds 배열의 크기입니다.

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

결과의 세부 정보 수준입니다. 기본적으로 기본 타이틀 수준 정보를 가져오는 XblPresenceDetailLevel::Title로 설정됩니다. 리치 현재 상태 정보를 가져오려면 XblPresenceDetailLevel::All로 설정합니다.

*onlineOnly*\
Type: bool

true이면 API가 오프라인 상태인 사용자의 레코드를 필터링합니다.

*broadcastingOnly*\
Type: bool

true이면 API가 방송 중이 아닌 사용자의 레코드를 필터링합니다.

## Remarks

필터를 제공하지 않으면 기본값이 사용됩니다.<br /> - 모든 디바이스의 가능한 모든 타이틀에 대한 레코드를 반환합니다.<br /> - 기본적으로 기본 타이틀 수준 정보 가져오기와 동일한 XblPresenceDetailLevel::Default(XblPresenceDetailLevel::Title과 동일)로 설정됩니다.<br /> - 오프라인이거나 방송 중인 사용자를 필터링하지 않습니다.<br />

## Argument of

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

## Requirements

**Header:** presence\_c.h

## See also

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


## Related topics

- [XblPresenceDetailLevel](/ko/reference/live/xsapi-c/presence_c/enums/xblpresencedetaillevel.md)
- [XblPresenceDeviceType](/ko/reference/live/xsapi-c/presence_c/enums/xblpresencedevicetype.md)
- [XblPresenceGetPresenceForMultipleUsersAsync](/ko/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceformultipleusersasync.md)
- [사용자의 Presence 가져오기](/ko/services/xbox-services/community/presence/how-to/live-getting-a-users-presence.md)
- [XblPresenceGetPresenceForSocialGroupAsync](/ko/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md)