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 포함) |
참고 항목
조이스틱
멀티미디어 조이스틱 구조체