Поделиться через

Функция 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
 Недопустимый идентификатор джойстика или hwnd имеет значение NULL.
JOYERR_NOCANDO
 Не удается записать входные данные джойстика, так как требуемая служба (например, таймер Windows) недоступна.
JOYERR_UNPLUGGED
 Указанный джойстик не подключен к системе.
JOYERR_PARMS
 Недопустимый идентификатор джойстика или hwnd имеет значение NULL.

Комментарии

Если указанный джойстик фиксируется в данный момент, функция возвращает неопределенное поведение. Вызовите функцию joyReleaseCapture , чтобы освободить захваченный джойстик, или уничтожьте окно, чтобы освободить джойстик автоматически.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header joystickapi.h (включая Windows.h)
Библиотека Winmm.lib
DLL Winmm.dll

См. также раздел

Джойстики

Функции мультимедийного джойстика