다음을 통해 공유

joyGetPosEx 함수(joystickapi.h)

  • 아티클

joyGetPosEx 함수는 조이스틱의 위치 및 단추 상태 쿼리합니다.

구문

MMRESULT joyGetPosEx(
  UINT        uJoyID,
  LPJOYINFOEX pji
);

매개 변수

uJoyID

쿼리할 조이스틱의 식별자입니다. uJoyID의 유효한 값은 0(JOYSTICKID1)에서 15까지입니다.

pji

조이스틱의 확장된 위치 정보 및 단추 상태 포함된 JOYINFOEX 구조체에 대한 포인터입니다. dwSize 및 dwFlags 멤버를 설정해야 합니다. 그렇지 않으면 joyGetPosEx가 실패합니다. joyGetPosEx에서 반환되는 정보는 dwFlags에서 지정한 플래그에 따라 달라집니다.

반환 값

성공하거나 다음 오류 값 중 하나이면 JOYERR_NOERROR 반환합니다.

반환 코드 설명
MMSYSERR_NODRIVER
 조이스틱 드라이버가 없습니다.
MMSYSERR_INVALPARAM
 잘못된 매개 변수가 전달되었습니다.
MMSYSERR_BADDEVICEID
 지정된 조이스틱 식별자가 잘못되었습니다.
JOYERR_UNPLUGGED
 지정된 조이스틱이 시스템에 연결되어 있지 않습니다.
JOYERR_PARMS
 지정된 조이스틱 식별자가 잘못되었습니다.

설명

이 함수는 최대 6개의 축을 사용하여 방향타 페달, 시점 모자, 단추 수가 많은 디바이스 및 좌표계와 같은 확장된 디바이스에 액세스할 수 있도록 합니다. 3축 이하를 사용하고 단추가 4개 미만인 조이스틱 장치의 경우 joyGetPos 함수를 사용합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 joystickapi.h(Windows.h 포함)
라이브러리 Winmm.lib
DLL Winmm.dll

추가 정보

조이스틱

멀티미디어 조이스틱 함수