XInputGetState 函式 ()
擷取指定控制器的目前狀態。
語法
DWORD XInputGetState(
[in] DWORD dwUserIndex,
[out] XINPUT_STATE *pState
);
參數
[in] dwUserIndex
使用者控制器的索引。 可以是從 0 到 3 的值。 如需如何判斷此值以及如何將值對應至控制器上指標的資訊，請參閱 多個控制器。
[out] pState
接收控制器目前狀態 之XINPUT_STATE 結構的指標。
傳回值
如果函式成功，傳回值 會ERROR_SUCCESS。
如果控制器未連線，傳回值 會ERROR_DEVICE_NOT_CONNECTED。
如果函式失敗，傳回值是 Winerror.h 中定義的錯誤碼。 函式不會使用 SetLastError 來設定呼叫線程的最後一個錯誤碼。
備註
當 XInputGetState 用來擷取控制器數據時，會分別報告左右觸發程式。 基於舊版的原因，當 DirectInput 擷取控制器數據時，兩個觸發程式會共用相同的座標軸。 舊版行為在目前的遊戲裝置 控制台 中是明顯的，它會使用 DirectInput 進行控制器狀態。
平臺需求
Windows 8 (XInput 1.4) 、DirectX SDK (XInput 1.3) 、Windows Vista (XInput 9.1.0)規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | xinput.h |
| 程式庫 | Xinput.lib;Xinput9_1_0.lib |
| Dll | Xinput1_4.dll;Xinput9_1_0.dll;Xinputuap.dll |