JOYINFOEX 구조체(joystickapi.h)

JOYINFOEX 구조체에는 조이스틱 위치, 시점 위치 및 단추 상태에 대한 확장된 정보가 포함되어 있습니다.

구문

typedef struct joyinfoex_tag {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwXpos;
  DWORD dwYpos;
  DWORD dwZpos;
  DWORD dwRpos;
  DWORD dwUpos;
  DWORD dwVpos;
  DWORD dwButtons;
  DWORD dwButtonNumber;
  DWORD dwPOV;
  DWORD dwReserved1;
  DWORD dwReserved2;
} JOYINFOEX, *PJOYINFOEX, *NPJOYINFOEX, *LPJOYINFOEX;

멤버

dwSize

이 구조체의 크기(바이트)입니다.

dwFlags

이 구조체에서 반환된 유효한 정보를 나타내는 플래그입니다. 유효한 정보를 포함하지 않는 멤버는 0으로 설정됩니다. 다음 플래그가 정의됩니다.

플래그	설명
JOY_RETURNALL	JOY_RETURNRAWDATA 제외한 모든 JOY_RETURN 비트를 설정하는 것과 같습니다.
JOY_RETURNBUTTONS	dwButtons 멤버에는 각 조이스틱 단추의 상태에 대한 유효한 정보가 포함되어 있습니다.
JOY_RETURNCENTERED	조이스틱 중립 위치를 각 이동 축의 가운데 값으로 가운데에 배치합니다.
JOY_RETURNPOV	dwPOV 멤버에는 개별 단위로 표현된 뷰 지점 컨트롤에 대한 유효한 정보가 포함되어 있습니다.
JOY_RETURNPOVCTS	dwPOV 멤버에는 연속 100도 단위로 표현된 관점 컨트롤에 대한 유효한 정보가 포함되어 있습니다.
JOY_RETURNR	dwRpos 멤버에는 유효한 방향타 페달 데이터가 포함되어 있습니다. 이 정보는 다른(네 번째) 축을 나타냅니다.
JOY_RETURNRAWDATA	이 구조에 저장된 데이터는 크기 조정되지 않은 조이스틱 판독값입니다.
JOY_RETURNU	dwUpos 멤버는 조이스틱의 다섯 번째 축에 대한 유효한 데이터를 포함하며, 이러한 축을 사용할 수 있는 경우 0을 반환합니다.
JOY_RETURNV	dwVpos 멤버는 조이스틱의 여섯 번째 축에 대한 유효한 데이터를 포함하며, 이러한 축을 사용할 수 있는 경우 0을 반환합니다.
JOY_RETURNX	dwXpos 멤버는 조이스틱의 x 좌표에 대한 유효한 데이터를 포함합니다.
JOY_RETURNY	dwYpos 멤버에는 조이스틱의 y 좌표에 대한 유효한 데이터가 포함되어 있습니다.
JOY_RETURNZ	dwZpos 멤버에는 조이스틱의 z 좌표에 대한 유효한 데이터가 포함되어 있습니다.

 

다음 플래그는 조이스틱을 보정하는 데이터를 제공하며 사용자 지정 보정 애플리케이션을 위한 것입니다.

플래그	설명
JOY_CAL_READ3	x-, y 및 z 좌표를 읽고 원시 값을 dwXpos, dwYpos 및 dwZpos에 저장 합니다.
JOY_CAL_READ4	방향타 정보와 x-, y 및 z 좌표를 읽고 원시 값을 dwXpos, dwYpos, dwZpos 및 dwRpos에 저장합니다.
JOY_CAL_READ5	방향타 정보 및 x-, y-, z 및 사용자 좌표를 읽고 원시 값을 dwXpos, dwYpos, dwZpos, dwRpos 및 dwUpos에 저장합니다.
JOY_CAL_READ6	데이터를 제공할 조이스틱 미니 드라이버가 있는 경우 원시 v축 데이터를 읽습니다. 그렇지 않으면 0을 반환합니다.
JOY_CAL_READALWAYS	드라이버가 디바이스를 검색하지 않더라도 조이스틱 포트를 읽습니다.
JOY_CAL_READRONLY	데이터를 제공하고 원시 값을 dwRpos에 저장하는 조이스틱 미니 드라이버가 있는 경우 방향타 정보를 읽습니다. 그렇지 않으면 0을 반환합니다.
JOY_CAL_READXONLY	x 좌표를 읽고 원시(비보정) 값을 dwXpos에 저장합니다.
JOY_CAL_READXYONLY	x 및 y 좌표를 읽고 원시 값을 dwXpos 및 dwYpos 에 배치 합니다.
JOY_CAL_READYONLY	y 좌표를 읽고 원시 값을 dwYpos에 저장합니다.
JOY_CAL_READZONLY	z 좌표를 읽고 원시 값을 dwZpos에 저장합니다.
JOY_CAL_READUONLY	데이터를 제공하고 원시 값을 dwUpos에 저장하는 조이스틱 미니 드라이버가 있는 경우 u 좌표를 읽습니다. 그렇지 않으면 0을 반환합니다.
JOY_CAL_READVONLY	데이터를 제공하고 원시 값을 dwVpos에 저장하는 조이스틱 미니 드라이버가 있는 경우 v 좌표를 읽습니다. 그렇지 않으면 0을 반환합니다.

dwXpos

현재 X 좌표입니다.

dwYpos

현재 Y 좌표입니다.

dwZpos

현재 Z 좌표입니다.

dwRpos

방향타 또는 네 번째 조이스틱 축의 현재 위치입니다.

dwUpos

현재 다섯 번째 축 위치입니다.

dwVpos

현재 여섯 번째 축 위치입니다.

dwButtons

32 조이스틱 단추의 현재 상태입니다. 이 멤버의 값은 JOY_BUTTON n 플래그의 조합으로 설정할 수 있습니다. 여기서 n 은 누른 단추에 해당하는 1~32 범위의 값입니다.

dwButtonNumber

누른 현재 단추 번호입니다.

dwPOV

뷰 지점 컨트롤의 현재 위치입니다. 이 멤버의 값은 0~35,900 범위에 있습니다. 이러한 값은 각 보기의 각도(도)를 100으로 곱한 값을 나타냅니다.

dwReserved1

예약되어 있으므로 사용하지 마세요.

dwReserved2

예약되어 있으므로 사용하지 마세요.

설명

dwSize 멤버의 값은 joyGetPosEx 함수에 전달될 때 구조체의 버전 번호를 식별하는 데도 사용됩니다.

관점 제어가 있는 대부분의 디바이스에는 5개의 위치만 있습니다. JOY_RETURNPOV 플래그가 설정되면 다음 상수를 사용하여 이러한 위치를 보고합니다.

Point-of-View 플래그	설명
JOY_POVBACKWARD	시점 모자를 뒤로 눌렀습니다. 값 18,000은 180.00도(후면)의 방향을 나타냅니다.
JOY_POVCENTERED	포인트 오브 뷰 모자는 중립 위치에 있습니다. 값 -1은 특정 시점 모자에 보고할 각도가 없음을 의미합니다.
JOY_POVFORWARD	시점 모자를 앞으로 누릅니다. 값 0은 0.00도(바로 앞)의 방향을 나타냅니다.
JOY_POVLEFT	포인트 오브 뷰 모자가 왼쪽으로 눌리고 있습니다. 값 27,000은 270.00도(왼쪽 90.00도)의 방향을 나타냅니다.
JOY_POVRIGHT	포인트 오브 뷰 모자가 오른쪽으로 눌렀습니다. 값 9,000은 90.00도(오른쪽)의 방향을 나타냅니다.

 

기본 조이스틱 드라이버는 현재 이러한 5가지 불연속 방향을 지원합니다. 애플리케이션이 정의된 뷰 지점 값만 수락할 수 있는 경우 JOY_RETURNPOV 플래그를 사용해야 합니다. 애플리케이션이 다른 학위 판독값을 수락할 수 있는 경우 JOY_RETURNPOVCTS 플래그를 사용하여 사용 가능한 경우 연속 데이터를 가져와야 합니다. JOY_RETURNPOVCTS 플래그는 JOY_RETURNPOV 플래그와 함께 사용되는 JOY_POV 상수도 지원합니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	joystickapi.h(Windows.h 포함)

참고 항목

조이스틱

멀티미디어 조이스틱 구조체

joyGetPosEx