> ## 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`，且裝置不會產生新的讀數。如果裝置以相同的裝置識別碼重新連線 (請參閱 [IGameInputDevice::GetDeviceId](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceid.md))，GameInput 會重複使用相同的裝置物件，且 `IsConnected` 會再次傳回 `true`。

若要在裝置連線或中斷連線時收到通知，而不是輪詢此方法，請呼叫 [IGameInput::RegisterDeviceCallback](https://docs.xbox.com/zh-TW/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/zh-TW/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/zh-TW/build/core-features/common/input/overviews/input-overview.md)\
[IGameInputDevice](https://docs.xbox.com/zh-TW/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/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v4** | 已推出。 |


## Related topics

- [GameInputDeviceStatus (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/enums/gameinputdevicestatus.md)
- [GetDeviceStatus (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdevicestatus.md)
- [GameInputDeviceCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/functions/gameinputdevicecallback.md)
- [已淘汰的 GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/gameinput_members.md)