joyGetPosEx 函式 (遊戲桿api.h)
joyGetPosEx 函式會查詢遊戲桿的位置和按鈕狀態。
語法
MMRESULT joyGetPosEx(
UINT uJoyID,
LPJOYINFOEX pji
);
參數
uJoyID
要查詢之遊戲桿的識別碼。 uJoyID 的有效值範圍從零 (JOYSTICKID1) 到 15。
pji
包含遊戲桿延伸位置資訊和按鈕狀態之 JOYINFOEX 結構的指標。 您必須設定 dwSize 和 dwFlags 成員或 joyGetPosEx 將會失敗。 從 joyGetPosEx 傳回的信息取決於您在 dwFlags 中指定的旗標。
傳回值
如果成功或下列其中一個錯誤值，則傳回JOYERR_NOERROR。
| 傳回碼 | Description |
|---|---|
|
遊戲桿驅動程式不存在。 |
|
傳遞了一個無效的參數。 |
|
指定的遊戲桿識別碼無效。 |
|
指定的遊戲桿未連線到系統。 |
|
指定的遊戲桿識別碼無效。 |
備註
此函式提供擴充裝置的存取權，例如 rudder 滑桿、檢視點帽、具有大量按鈕的裝置，以及使用最多六個軸的座標系統。 對於使用三個軸或更少且少於四個按鈕的遊戲桿裝置，請使用 「遊戲桿」 函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | jostickapi.h (包含 Windows.h) |
| 程式庫 | Winmm.lib |
| Dll | Winmm.dll |