共用方式為


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

另請參閱

XINPUT_GAMEPAD

XINPUT_STATE

XInput 函式

XInputSetState