IXtfInputClient::ConnectGamepad メソッド

[アーティクル]
2023-05-09

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

構文

public:
HRESULT ConnectGamepad(
         UINT64 *pControllerId
)

パラメーター

pControllerId
型: UINT64 *

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

戻り値

型: HRESULT

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

解説

ConnectGamepad は、作成された仮想コントローラーごとにシステムリソースを割り当てると同時に、これら仮想コントローラーの識別子を返します。この識別子は、IXtfInputClient::SendGamepadReport を使用して開発機本体に入力を送信するために使用されます。作成するコードでは、本体が確実に新しいコントローラーの登録を終えて入力を受け付ける準備ができるようにするため、ConnectGamepad を呼び出した後、2 秒間待機したうえで SendGamepadReport を呼び出す必要があります。作成するコードでは、必ず ConnectGamepad の呼び出しと DisconnectGamepad の呼び出しをペアにすることで、これらのシステムリソースを解放して再利用できるようにする必要があります。また、ixtfinputclient::D isconnectAllGamepads を呼び出して、すべての仮想コントローラーのリソースを一度に解放することもできます。

要件

ヘッダー: xtfinput.h

ライブラリ: xtfinput.lib

サポートされているプラットフォーム: Windows (Xbox 本体ツール用)

次の方法で共有

IXtfInputClient::ConnectGamepad メソッド

構文

パラメーター

戻り値

解説

要件

関連項目

その他のリソース