Структура JOYCAPSW (joystickapi.h)

Статья
11/20/2024

Структура JOYCAPS содержит сведения о возможностях джойстика.

Синтаксис

typedef struct tagJOYCAPSW {
  WORD  wMid;
  WORD  wPid;
  WCHAR szPname[MAXPNAMELEN];
  UINT  wXmin;
  UINT  wXmax;
  UINT  wYmin;
  UINT  wYmax;
  UINT  wZmin;
  UINT  wZmax;
  UINT  wNumButtons;
  UINT  wPeriodMin;
  UINT  wPeriodMax;
  UINT  wRmin;
  UINT  wRmax;
  UINT  wUmin;
  UINT  wUmax;
  UINT  wVmin;
  UINT  wVmax;
  UINT  wCaps;
  UINT  wMaxAxes;
  UINT  wNumAxes;
  UINT  wMaxButtons;
  WCHAR szRegKey[MAXPNAMELEN];
  WCHAR szOEMVxD[MAX_JOYSTICKOEMVXDNAME];
} JOYCAPSW, *PJOYCAPSW, *NPJOYCAPSW, *LPJOYCAPSW;

Члены

wMid

Идентификатор производителя. Идентификаторы изготовителя определяются в изготовителя и идентификаторов продуктов.

wPid

Идентификатор продукта. Идентификаторы продуктов определяются в изготовителя и идентификаторов продуктов.

szPname[MAXPNAMELEN]

Строка, завершающаяся значением NULL, содержащая имя продукта джойстика.

wXmin

Минимальная координата X.

wXmax

Максимальная координата X.

wYmin

Минимальная координата Y.

wYmax

Максимальная координата Y.

wZmin

Минимальная координата Z.

wZmax

Максимальная координата Z.

wNumButtons

Количество кнопок джойстика.

wPeriodMin

Наименьшая частота опроса, поддерживаемая функцией joySetCapture.

wPeriodMax

Самая большая частота опроса, поддерживаемая при захвате joySetCapture.

wRmin

Минимальное значение руля. Руля — это четвертая ось перемещения.

wRmax

Максимальное значение руля. Руля — это четвертая ось перемещения.

wUmin

Минимальные значения координат u (пятая ось).

wUmax

Максимальные значения u-координат (пятая ось).

wVmin

Минимальные значения координат v (шестой оси).

wVmax

Максимальные значения координат v (шестая ось).

wCaps

Возможности Джойстика: Следующие флаги определяют отдельные возможности, которые могут иметь джойстик:

Флаг	Описание
JOYCAPS_HASZ	Джойстик содержит сведения о координатах z.
JOYCAPS_HASR	Джойстик имеет сведения о рулях (четвертая ось).
JOYCAPS_HASU	Джойстик содержит сведения о координатах (пятая ось).
JOYCAPS_HASV	Джойстик содержит сведения о виртуальной координате (шестая ось).
JOYCAPS_HASPOV	Джойстик содержит сведения о точке зрения.
JOYCAPS_POV4DIR	Джойстик точки представления поддерживает дискретные значения (по центру, вперед, назад, влево и вправо).
JOYCAPS_POVCTS	Джойстик точки зрения поддерживает непрерывные градусы.

wMaxAxes

Максимальное количество осей, поддерживаемых джойстиком.

wNumAxes

Количество осей, используемых в настоящее время джойстиком.

wMaxButtons

Максимальное количество кнопок, поддерживаемых джойстиком.

szRegKey[MAXPNAMELEN]

Строка, завершающаяся значением NULL, содержащая раздел реестра для джойстика.

szOEMVxD[MAX_JOYSTICKOEMVXDNAME]

Строка, завершающая значение NULL, определяющая ИЗГОТОВИТЕЛЬ драйвера джойстика.

Замечания

Заметка

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

Требования

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

См. также

Джойстики

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

joySetCapture

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