共用方式為

joyGetPosEx 函式 (遊戲桿api.h)

  • 發行項

joyGetPosEx 函式會查詢遊戲桿的位置和按鈕狀態。

語法

MMRESULT joyGetPosEx(
  UINT        uJoyID,
  LPJOYINFOEX pji
);

參數

uJoyID

要查詢之遊戲桿的識別碼。 uJoyID 的有效值範圍從零 (JOYSTICKID1) 到 15。

pji

包含遊戲桿延伸位置資訊和按鈕狀態之 JOYINFOEX 結構的指標。 您必須設定 dwSize 和 dwFlags 成員或 joyGetPosEx 將會失敗。 從 joyGetPosEx 傳回的信息取決於您在 dwFlags 中指定的旗標。

傳回值

如果成功或下列其中一個錯誤值，則傳回JOYERR_NOERROR。

傳回碼 Description
MMSYSERR_NODRIVER
 遊戲桿驅動程式不存在。
MMSYSERR_INVALPARAM
 傳遞了一個無效的參數。
MMSYSERR_BADDEVICEID
 指定的遊戲桿識別碼無效。
JOYERR_UNPLUGGED
 指定的遊戲桿未連線到系統。
JOYERR_PARMS
 指定的遊戲桿識別碼無效。

備註

此函式提供擴充裝置的存取權，例如 rudder 滑桿、檢視點帽、具有大量按鈕的裝置，以及使用最多六個軸的座標系統。 對於使用三個軸或更少且少於四個按鈕的遊戲桿裝置，請使用 「遊戲桿」 函式。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 jostickapi.h (包含 Windows.h)
程式庫 Winmm.lib
Dll Winmm.dll

另請參閱

操縱桿

多媒體遊戲桿函式