> ## 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.

# ConnectGamepad

> IXtfInputClient::ConnectGamepad メソッド

# IXtfInputClient::ConnectGamepad メソッド

仮想コントローラーを作成し、そのデバイス識別子を取得します。

## 構文

```cpp theme={null}
public:
HRESULT ConnectGamepad(
         UINT64 *pControllerId
)  
```

### パラメーター

*pControllerId*\
型: UINT64 \*

この [IXtfInputClient](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md) のデバイス識別子を受け取る UINT64 へのポインター。

### 戻り値

型: HRESULT

HRESULT の成功またはエラー コード。

## 解説

**ConnectGamepad** は、作成される各仮想コントローラーにシステム リソースを割り当てるとともに、[IXtfInputClient::SendGamepadReport](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md) を使用して開発コンソールに入力を送信する際に使用する仮想コントローラーの識別子を返します。**ConnectGamepad** を呼び出した後、コンソールが新しいコントローラーの登録を完了して入力を受け入れる準備ができていることを確認するために、コードでは [SendGamepadReport](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md) を呼び出す前に 2 秒間待機する必要があります。これらのシステム リソースが解放されて再利用可能になるようにするため、コードでは常に **ConnectGamepad** の呼び出しと [DisconnectGamepad](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md) の呼び出しをペアで実行する必要があります。すべての仮想コントローラー リソースを一度に解放するために、[IXtfInputClient::DisconnectAllGamepads](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md) を呼び出すこともできます。

## 要件

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

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

**対応プラットフォーム:** Windows (XBOX コンソール ツール用)

## 関連項目

[XtfInput](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/xtfinput-xbox-microsoft-n.md)\
[IXtfInputClient](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/classes/IXtfInputClient/ixtfinputclient-xtfinput-xbox-windows-t.md)\
[IXtfInputClient::ConnectGamepad](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/connectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)\
[IXtfInputClient::DisconnectGamepad](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)\
[IXtfInputClient::DisconnectAllGamepads](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)


## Related topics

- [GAMEPAD_REPORT_EX](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/structures/gamepad_report_ex.md)
- [DisconnectGamepad](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectgamepad-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [SendGamepadReport](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/sendgamepadreport-ixtfinputclient-xtfinput-xbox-windows-m.md)
- [GAMEPAD_REPORT 構造体](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/structures/GAMEPAD_REPORT-xtfinput-xbox-windows-t.md)
- [DisconnectAllGamepads](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfinput/classes/IXtfInputClient/methods/disconnectallgamepads-ixtfinputclient-xtfinput-xbox-windows-m.md)