Skip to main content

XblPresenceQueryFilters

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

Syntax

Members

deviceTypes
Type: const XblPresenceDeviceType*
디바이스 유형의 배열입니다. 이 필드가 null이면 가능한 모든 deviceTypes로 기본 설정됩니다. deviceTypesCount
Type: size_t
deviceTypes 배열의 크기입니다. titleIds
Type: const uint32_t*
결과를 필터링하기 위한 titleIds 목록입니다. 입력이 빈 벡터이면 가능한 모든 타이틀로 기본 설정됩니다. titleIdsCount
Type: size_t
titleIds 배열의 크기입니다. detailLevel
Type: XblPresenceDetailLevel
결과의 세부 정보 수준입니다. 기본적으로 기본 타이틀 수준 정보를 가져오는 XblPresenceDetailLevel::Title로 설정됩니다. 리치 현재 상태 정보를 가져오려면 XblPresenceDetailLevel::All로 설정합니다. onlineOnly
Type: bool
true이면 API가 오프라인 상태인 사용자의 레코드를 필터링합니다. broadcastingOnly
Type: bool
true이면 API가 방송 중이 아닌 사용자의 레코드를 필터링합니다.

Remarks

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

Argument of

XblPresenceGetPresenceForMultipleUsersAsync
XblPresenceGetPresenceForSocialGroupAsync

Requirements

Header: presence_c.h

See also

presence_c
마지막 수정일 2026년 8월 13일