IDirectInputDevice8::Poll 메서드

Microsoft® DirectInput® 장치 위에의 폴링 대상 개체로부터 데이터를 얻어온다. 장치에 폴링이 필요없을 때에, 이 메서드를 호출해도 효과는 없다. 폴링 할 필요가 있는 장치가 정기적으로 폴링 되지 않는 경우, 이 장치로부터 새로운 데이터는 취득되지 않는다. 이 메서드를 호출하면, DirectInput 는 장치 상태를 갱신해, 버퍼링 데이터가 사용 가능한 경우는 입력 이벤트를 생성해, 통지가 유효한 경우는 통지 이벤트를 설정한다.

구문

HRESULT Poll(VOID);

반환값

성공했을 경우는, DI_OK 를 돌려준다. 장치가 폴링을 요구하지 않는 경우는,DI_NOEFFECT 를 돌려준다.

실패했을 경우는, 다음의 몇개의 에러값을 돌려준다.

DIERR_INPUTLOST	입력 장치에의 액세스가 없어졌다. 재취득해야 한다.
DIERR_NOTACQUIRED	조작은, 장치가 취득되지 않는 한 실행할 수 없다.
DIERR_NOTINITIALIZED	이 개체는 초기화되지 않다.

주의

장치 데이터를 폴링 하기 전에,IDirectInputDevice8::SetDataFormat 또는 IDirectInputDevice8::SetActionMap 메서드로 데이터 형식을 설정해,IDirectInputDevice8::Acquire 메서드로 장치를 취득해 두지 않으면 안 된다.

참조

폴링과 이벤트 통지