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