joySetCapture 函式 (搖桿api.h)

joySetCapture函式會藉由將搖桿的訊息傳送至指定的視窗來擷取搖桿。

語法

MMRESULT joySetCapture(
  HWND hwnd,
  UINT uJoyID,
  UINT uPeriod,
  BOOL fChanged
);

hwnd

視窗的控制碼，以接收搖桿訊息。

uJoyID

要擷取之搖桿的識別碼。 uJoyID的有效值範圍從零 (JOYID1) 到 15。

uPeriod

輪詢頻率，以毫秒為單位。

fChanged

變更位置旗標。只有當位置的值大於搖桿移動閾值時，才指定這個參數的 TRUE 來傳送訊息。否則，訊息會以 uPeriod中指定的輪詢頻率傳送。

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

傳回碼	描述
MMSYSERR_NODRIVER	搖桿驅動程式不存在。
MMSYSERR_INVALPARAM	不正確搖桿識別碼或 hwnd 為 Null。
JOYERR_NOCANDO	無法擷取搖桿輸入，因為 Windows 計時器) 等必要服務 (無法使用。
JOYERR_UNPLUGGED	指定的搖桿未連線到系統。
JOYERR_PARMS	不正確搖桿識別碼或 hwnd 為 Null。

如果目前擷取指定的搖桿，函式會傳回未定義的行為。呼叫 joyReleaseCapture 函式以釋放擷取的搖桿，或終結視窗以自動釋放搖桿。


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