функция joyGetDevCapsA (joystickapi.h)

Статья
11/20/2024

Функция joyGetDevCaps запрашивает джойстик для определения его возможностей.

Синтаксис

MMRESULT joyGetDevCapsA(
  UINT_PTR   uJoyID,
  LPJOYCAPSA pjc,
  UINT       cbjc
);

Параметры

uJoyID

Идентификатор джойстика, запрашиваемого. Допустимые значения для диапазоне от -1 до 15. Значение -1 позволяет получить элемент szRegKey структуры JOYCAPS, присутствует ли устройство.

pjc

Указатель на структуру JOYCAPS, чтобы содержать возможности джойстика.

cbjc

Размер в байтах структуры JOYCAPS.

Возвращаемое значение

Возвращает JOYERR_NOERROR в случае успешного выполнения или одного из следующих значений ошибок:

Возвращаемый код	Описание
MMSYSERR_NODRIVER	Драйвер джойстика отсутствует, или указанный идентификатор джойстика является недопустимым. Указанный идентификатор джойстика недопустим.
MMSYSERR_INVALPARAM	Недопустимый параметр был передан.

Замечания

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

Этот метод завершается ошибкой при передаче недопустимого значения для параметра cbjc.

Заметка

Заголовок joystickapi.h определяет joyGetDevCaps в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	joystickapi.h (включая Windows.h)
библиотеки	Winmm.lib
DLL	Winmm.dll

См. также

Джойстики
функции Мультимедиа Джойстик

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