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

> 入力デバイスが現在接続されているかどうかを示します。

入力デバイスが現在接続されているかどうかを示します。

## 構文

```cpp theme={null}
bool IsConnected();
```

### パラメーター

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

### 戻り値

型: bool

デバイスが現在接続されている場合は `true`。それ以外の場合は `false`。

## 解説

`IGameInputDevice` オブジェクトは物理デバイスが切断された後も有効なままであるため、アプリケーションはそのオブジェクトへの参照を保持できます。デバイスが切断されている間、`IsConnected` は `false` を返し、デバイスは新しい読み取りを生成しません。デバイスが同じデバイス ID ([IGameInputDevice::GetDeviceId](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceid.md) を参照) で再接続されると、GameInput は同じデバイス オブジェクトを再利用し、`IsConnected` は再び `true` を返します。

このメソッドをポーリングする代わりに、デバイスの接続時または切断時に通知を受け取るには、[IGameInput::RegisterDeviceCallback](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md) を呼び出してデバイス コールバックを登録します。コールバックは、[GameInputDeviceEvent](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent) の `GameInputDeviceEventConnected` 値と `GameInputDeviceEventDisconnected` 値を受け取ります。

GameInput v3 以前では、[IGameInputDevice::GetDeviceStatus](https://docs.xbox.com/ja-jp/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdevicestatus.md) から返される値に `GameInputDeviceConnected` フラグが含まれているかどうかを確認していました。

## 要件

**ヘッダー:** 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)\
[GameInputDeviceEvent](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent)\
[IGameInput::RegisterDeviceCallback](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)

## バージョン履歴

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


## Related topics

- [GameInputDeviceStatus (非推奨)](https://docs.xbox.com/ja-jp/reference/input/gameinput/deprecated/enums/gameinputdevicestatus.md)
- [GetDeviceStatus (非推奨)](https://docs.xbox.com/ja-jp/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdevicestatus.md)
- [GameInputDeviceCallback](https://docs.xbox.com/ja-jp/reference/input/gameinput/functions/gameinputdevicecallback.md)
- [IGameInputDevice (インターフェイスの内容)](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [IGameInputDevice::GetXInputDeviceIndex](https://docs.xbox.com/ja-jp/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getxinputdeviceindex.md)