Skip to main content

IXtfInputClient::ConnectGamepad メソッド

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

構文

パラメーター

pControllerId
型: UINT64 *
この IXtfInputClient のデバイス識別子を受け取る UINT64 へのポインター。

戻り値

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

解説

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

要件

ヘッダー: xtfinput.h ライブラリ: xtfinput.lib 対応プラットフォーム: Windows (XBOX コンソール ツール用)

関連項目

XtfInput
IXtfInputClient
IXtfInputClient::ConnectGamepad
IXtfInputClient::DisconnectGamepad
IXtfInputClient::DisconnectAllGamepads
最終更新日 2026年8月24日