joySetCapture 함수(joystickapi.h)

joySetCapture 함수는 지정된 창으로 메시지를 보내 조이스틱을 캡처합니다.

구문

MMRESULT joySetCapture(
  HWND hwnd,
  UINT uJoyID,
  UINT uPeriod,
  BOOL fChanged
);

hwnd

조이스틱 메시지를 수신하기 위해 창에 대한 핸들입니다.

uJoyID

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

uPeriod

폴링 빈도(밀리초)입니다.

fChanged

위치 플래그를 변경합니다. 위치가 조이스틱 이동 임계값보다 큰 값으로 변경되는 경우에만 메시지를 보내려면 이 매개 변수에 TRUE 를 지정합니다. 그렇지 않으면 메시지는 uPeriod에 지정된 폴링 빈도로 전송됩니다.

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

반환 코드	설명
MMSYSERR_NODRIVER	조이스틱 드라이버가 없습니다.
MMSYSERR_INVALPARAM	조이스틱 ID 또는 hwnd가 NULL이 잘못되었습니다.
JOYERR_NOCANDO	필요한 서비스(예: Windows 타이머)를 사용할 수 없으므로 조이스틱 입력을 캡처할 수 없습니다.
JOYERR_UNPLUGGED	지정된 조이스틱이 시스템에 연결되어 있지 않습니다.
JOYERR_PARMS	조이스틱 ID 또는 hwnd가 NULL이 잘못되었습니다.

지정된 조이스틱이 현재 캡처된 경우 함수는 정의되지 않은 동작을 반환합니다. joyReleaseCapture 함수를 호출하여 캡처된 조이스틱을 해제하거나 창을 파괴하여 조이스틱을 자동으로 해제합니다.


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