共用方式為

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

另請參閱

操縱 杆

多媒體搖桿函式