XInputGetCapabilities
接続されているコントローラーの性能や機能を取得します。
構文
DWORD XInputGetCapabilities(
DWORD dwUserIndex,
DWORD dwFlags,
XINPUT_CAPABILITIES * pCapabilities
)
パラメーター
dwUserIndex _In_
型: DWORD
デバイスに関連付けられたゲーマーのインデックス。0 ～ XUSER_MAX_COUNT - 1 の範囲の値です。
dwFlags _In_
型: DWORD
コントローラーの種類を識別する入力フラグです。 この値が 0 の場合、システムに接続されているすべてのコントローラーの機能が返されます。 現在、XINPUT_FLAG_GAMEPAD のみがサポートされています。
pCapabilities _Out_
型: XINPUT_CAPABILITIES*
コントローラーの機能を受け取る XINPUT_CAPABILITIES オブジェクトへのポインターです。
戻り値
型: DWORD
関数が成功した場合、戻り値は ERROR_SUCCESS です。
コントローラーが接続されていない場合、戻り値は ERROR_DEVICE_NOT_CONNECTED です。
関数が失敗した場合、戻り値は WinError.h で定義されたエラー コードです。 関数は、呼び出しスレッドの最後のエラー コードを設定するために SetLastError を使用しません。
解説
注意
従来の XINPUT 9.1.0 バージョン (Windows Vista 以降に含まれました) では、接続されているデバイスに関係なく常に固定の機能セットを返しました。
報告された機能の詳細については、XINPUT_CAPABILITIES を参照してください。
詳細については、「XInputOnGameInput ラッパー」を参照してください。
要件
ヘッダー: XInputOnGameInput.h
ライブラリ: xgameruntime.lib
サポートされているプラットフォーム: Xbox One ファミリー本体、Xbox Series 本体