> ## 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 に渡される構造体。

## 構文

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

### メンバー

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

デバイスの種類の配列。このフィールドが null の場合、可能なすべての deviceTypes が既定になります。

*deviceTypesCount*\
型: size\_t

deviceTypes 配列のサイズ。

*titleIds*\
型: const uint32\_t\*

結果をフィルターするための titleId のリスト。入力が空のベクターの場合、可能なすべてのタイトルが既定になります。

*titleIdsCount*\
型: size\_t

titleIds 配列のサイズ。

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

結果の詳細レベル。既定は XblPresenceDetailLevel::Title で、基本的なタイトル レベルの情報を取得します。リッチ プレゼンス情報を取得するには、XblPresenceDetailLevel::All を設定してください。

*onlineOnly*\
型: bool

true の場合、API はオフラインのユーザーのレコードをフィルターで除外します。

*broadcastingOnly*\
型: bool

true の場合、API はブロードキャストしていないユーザーのレコードをフィルターで除外します。

## 解説

フィルターが指定されていない場合、既定値が使用されます:<br /> - すべてのデバイス上の可能なすべてのタイトルのレコードを返します。<br /> - 既定は XblPresenceDetailLevel::Default で、XblPresenceDetailLevel::Title (基本的なタイトル レベルの情報を取得) と同等です。<br /> - オフラインまたはブロードキャストしているユーザーをフィルターで除外しません。<br />

## 引数として使用する関数

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

## 要件

**ヘッダー:** presence\_c.h

## 関連項目

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


## Related topics

- [XblPresenceDetailLevel](/ja-jp/reference/live/xsapi-c/presence_c/enums/xblpresencedetaillevel.md)
- [XblPresenceDeviceType](/ja-jp/reference/live/xsapi-c/presence_c/enums/xblpresencedevicetype.md)
- [XblPresenceGetPresenceForMultipleUsersAsync](/ja-jp/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceformultipleusersasync.md)
- [ユーザーのプレゼンスの取得](/ja-jp/services/xbox-services/community/presence/how-to/live-getting-a-users-presence.md)
- [XblPresenceGetPresenceForSocialGroupAsync](/ja-jp/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md)