XINPUT_CAPABILITIES 結構 ()

發行項
03/13/2024

描述線上控制器的功能。 XInputGetCapabilities 函式會傳回XINPUT_CAPABILITIES。

語法

typedef struct _XINPUT_CAPABILITIES {
  BYTE             Type;
  BYTE             SubType;
  WORD             Flags;
  XINPUT_GAMEPAD   Gamepad;
  XINPUT_VIBRATION Vibration;
} XINPUT_CAPABILITIES, *PXINPUT_CAPABILITIES;

成員

Type

控制器類型。它必須是下列其中一個值。

值	Description
XINPUT_DEVTYPE_GAMEPAD	裝置是遊戲控制器。

SubType

遊戲控制器的子類型。如需允許的子類型清單，請參閱一份允許的 SUBTYPE 和 Controller 子類型。

注意如需使用此子類型值的限制，請參閱。未來可能會新增更多子類型。

Flags

控制器的功能。

值	Description
XINPUT_CAPS_VOICE_SUPPORTED	裝置具有整合式語音裝置。
XINPUT_CAPS_FFB_SUPPORTED	裝置支持強制意見反應功能。請注意，這些超越殘響的強制回饋功能目前不支援透過 Windows 上的一個的一個的一個 POWERPUT。
XINPUT_CAPS_WIRELESS	裝置為無線。
XINPUT_CAPS_PMD_SUPPORTED	裝置支援外掛程式模組。請注意，目前不支援像是文字輸入設備 (TID) 的外掛程式模組，目前透過 Windows 上的一般的一般功能。
XINPUT_CAPS_NO_NAVIGATION	裝置缺少功能表流覽按鈕， (START、BACK、DPAD) 。

Gamepad

XINPUT_GAMEPAD 描述可用控制器功能和控制解析度的結構。

Vibration

描述可用震動功能和解析度的XINPUT_VIBRATION結構。

備註

XInputGetCapabilities 會 傳回XINPUT_CAPABILITIES ，以指出指定控制器的特性和可用功能。

XInputGetCapabilities 會設定結構成員，以指出裝置支持的輸入。針對二進位狀態控制項，例如數位按鈕，對應的位會反映裝置是否支援控制項。對於比例控件，例如遊戲桿，值會指出該控件的解析度。可能未設定某些最小有效位的數目，表示控件未提供該層級的解析度。

SubType 成員表示控制器存在的特定子類型。遊戲可能會偵測控制器子類型，並根據適合其遊戲內容類型的子類型來微調控制器輸入或輸出的處理。例如，汽車賽車遊戲可能會檢查是否有滾輪控制器，以提供更精細的汽車驅動控制權。不過，標題不得根據其子類型停用或忽略裝置。遊戲無法辨識子類型，或未特別調整遊戲的子類型，應該視為標準控制器 (XINPUT_DEVSUBTYPE_GAMEPAD) 。

較舊的 XUSB Windows 驅動程式會報告不完整的功能資訊，特別是無線裝置。最新的 XUSB Windows 驅動程式提供有線和無線裝置的完整支援，以及更完整且精確的功能旗標。