IDirectInputDevice8::SetDataFormat 메서드

Microsoft® DirectInput® 장치의 데이터 형식을 설정한다.

구문

HRESULT SetDataFormat(      

    LPCDIDATAFORMAT lpdf
);

파라미터

lpdf

DirectInputDevice 가 돌려주는 데이터 형식을 기술하는 구조체의 주소. 애플리케이션은, 독자적인 DIDATAFORMAT 구조체를 정의하는 일도, 다음일 전정의된 글로벌 변수의 1 개를 사용할 수도 있다.

• c_dfDIKeyboard
• c_dfDIMouse
• c_dfDIMouse2
• c_dfDIJoystick
• c_dfDIJoystick2

반환값

성공했을 경우는, DI_OK 를 돌려준다.

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

DIERR_ACQUIRED	조작은, 장치가 취득 상태의 사이는 실행할 수 없다.
DIERR_INVALIDPARAM	무효인 파라미터가, 돌아오는 함수에 건네졌는지, 개체가 그 함수를 호출할 수 있는 상태에 없었다. 이 값은, 표준의 구성 요소 개체 모델 (COM) 반환값인 E_INVALIDARG 에 동일하다.
DIERR_NOTINITIALIZED	이 개체는 초기화되지 않다.

주의

IDirectInputDevice8::Acquire 로 장치를 얻어온다전에, 데이터 형식을 설정해 두지 않으면 안 된다. 데이터 형식은, 한 번 설정하는 것만으로 좋다. 데이터 형식은, 장치가 취득되고 있는 동안은 변경할 수 없다.

애플리케이션이 액션 맵을 사용하고 있는 경우는, 대신에 IDirectInputDevice8::SetActionMap 를 호출하는 것으로 데이터 형식이 설정된다.

참조

IDirectInputDevice8::GetDeviceState