XInputGetCapabilities 函式 ()
擷取連線控制器的功能和功能。
語法
DWORD XInputGetCapabilities(
[in] DWORD dwUserIndex,
[in] DWORD dwFlags,
[out] XINPUT_CAPABILITIES *pCapabilities
);
參數
[in] dwUserIndex
使用者控制器的索引。 可以是範圍 0-3 中的值。 如需如何決定此值以及如何將值對應至控制器上指標的資訊，請參閱 多個控制器。
[in] dwFlags
識別控制器類型的輸入旗標。 如果此值為 0，則會傳回所有連線至系統之控制器的功能。 目前僅支援一個值：
| 值 | Description |
|---|---|
| XINPUT_FLAG_GAMEPAD | 將查詢限制為控制器類型的裝置。 |
上述或 0 以外的 任何 dwflags 值不合法，而且會在偵錯時造成錯誤中斷。
[out] pCapabilities
接收控制器功能的 XINPUT_CAPABILITIES 結構的指標。
傳回值
如果函式成功，傳回值會 ERROR_SUCCESS。
如果控制器未連接，傳回值會 ERROR_DEVICE_NOT_CONNECTED。
如果函式失敗，傳回值是 WinError.h 中定義的錯誤碼。 函式不會使用 SetLastError 來設定呼叫執行緒的最後一個錯誤碼。
備註
注意 Windows Vista 和更新 (版本中隨附的舊版一律會傳回一組固定功能，而不論連接的裝置為何，Windows Vista 和更新版本) 一律會傳回一組固定的功能。
平臺需求
Windows 8 (XInput 1.4) 、DirectX SDK (XInput 1.3) 、Windows Vista (XInput 9.1.0)規格需求
| 目標平台 | Windows |
| 標頭 | xinput.h |
| 程式庫 | 一般Xinput9_1_0.lib |
| Dll | Xinput1_4.dll;Xinput9_1_0.dll |