> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IGameInputDevice::GetTouchSurfaceCount

> 入力デバイス上のタッチ サーフェスの数を取得します。

入力デバイス上のタッチ サーフェスの数を取得します。

## 構文

```cpp theme={null}
uint32_t GetTouchSurfaceCount();
```

### パラメーター

このメソッドにはパラメーターがありません。

### 戻り値

型: uint32\_t

デバイス上のタッチ サーフェスの数。デバイスにタッチ サーフェスがない場合は 0。

## 解説

タッチ サーフェスは、DualSense コントローラーや DualShock 4 コントローラーのタッチパッドなど、タッチの接触点を報告するデバイスの領域です。タッチ サーフェスを 1 つ以上備えたデバイスでは、[IGameInputDevice::GetSupportedInput](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md) から返される値に `GameInputKindTouch` が含まれます。

タッチ サーフェスは、このメソッドから返される値より小さい 0 から始まるインデックスで識別されます。このインデックスを使用して、[IGameInputDevice::GetTouchSurfaceInfo](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gettouchsurfaceinfo.md) を呼び出してサーフェスの説明を取得したり、[IGameInputReading::GetTouchSurfaceState](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_gettouchsurfacestate.md) を呼び出して読み取りからサーフェス上の接触点を読み取ったりします。

タッチ サーフェスの数は、デバイス オブジェクトの有効期間中は変化しません。

> [!NOTE]
>
> タッチのサポートは、デバイスとプラットフォームによって異なります。

## 要件

**ヘッダー:** GameInput.h

**ライブラリ:** gameinput.lib

**サポートされているプラットフォーム:** Windows、XBOX One ファミリー本体、XBOX Series 本体

## 関連項目

[GameInput の概要](https://docs.xbox.com/ja-jp/build/core-features/common/input/overviews/input-overview.md)\
[IGameInputDevice](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[IGameInputDevice::GetTouchSurfaceInfo](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gettouchsurfaceinfo.md)\
[GameInputTouchSurfaceInfo](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/structs/gameinputtouchsurfaceinfo)\
[IGameInputReading::GetTouchSurfaceState](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_gettouchsurfacestate.md)

## バージョン履歴

| バージョン | 変更内容 |
| - | - |
| **v4** | 導入されました。 |


## Related topics

- [IGameInputDevice::GetTouchSurfaceInfo](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gettouchsurfaceinfo.md)
- [IGameInputReading::GetTouchContactCount](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_gettouchcontactcount.md)
- [IGameInputReading::GetTouchSurfaceState](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_gettouchsurfacestate.md)
- [IGameInputDevice::GetSupportedInput](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md)
- [IGameInputDevice::GetInputReportCount](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getinputreportcount.md)
