joySetCapture 函数 (joystickapi.h)

joySetCapture 函数通过使游戏杆的消息发送到指定窗口来捕获游戏杆。

语法

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

hwnd

用于接收游戏杆消息的窗口的句柄。

uJoyID

要捕获的游戏杆的标识符。 uJoyID 的有效值范围为零 (JOYSTICKID1) 到 15。

uPeriod

轮询频率（以毫秒为单位）。

fChanged

更改位置标志。为此参数指定 TRUE ，以便仅当位置更改的值大于游戏杆移动阈值时发送消息。否则，将按 uPeriod 中指定的轮询频率发送消息。

如果成功或以下错误值之一，则返回JOYERR_NOERROR。

返回代码	说明
MMSYSERR_NODRIVER	游戏杆驱动程序不存在。
MMSYSERR_INVALPARAM	无效游戏杆 ID 或 hwnd 为 NULL。
JOYERR_NOCANDO	无法捕获游戏杆输入，因为所需的服务 (（如 Windows 计时器) ）不可用。
JOYERR_UNPLUGGED	指定的游戏杆未连接到系统。
JOYERR_PARMS	无效游戏杆 ID 或 hwnd 为 NULL。

如果当前捕获了指定的游戏杆，该函数将返回未定义的行为。调用 joyReleaseCapture 函数以释放捕获的游戏杆，或销毁窗口以自动释放游戏杆。


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	joystickapi.h (包括 Windows.h)
Library	Winmm.lib
DLL	Winmm.dll