IDirectInput8::Initialize 메서드

Microsoft® DirectInput® 개체를 초기화한다. 애플리케이션은, 보통, 이 메서드를 호출할 필요는 없다. DirectInput8Create 함수가, DirectInput 개체를 생성 한 후에 자동적으로 초기화를 실시한다.

구문

HRESULT Initialize(      

    HINSTANCE hinst,
    DWORD dwVersion
);

파라미터

hinst

DirectInput 개체를 생성 하는 애플리케이션 또는 DLL 의 인스턴스 핸들. DirectInput 는, 이 값을 사용해, 애플리케이션 또는 DLL 가 인정되고 있는지를 판단함과 동시에, 하위 호환성을 위해서(때문에) 필요한 동작을 확립한다.

DLL 가 부모의 애플리케이션의 핸들을 건네주면 에러가 된다. 예를 들어, Web 페이지에 파묻히고 있어 DirectInput 를 사용하는 Microsoft ActiveX® 컨트롤은, 브라우저의 핸들은 아니고, 그것 자신의 인스턴스의 핸들을 건네주지 않으면 안 된다. 이것에 의해, DirectInput 가 그 컨트롤을 인식해, 필요라고 생각되는 특별한 동작을 모두 유효하게 하는 것이 확실히 된다.

dwVersion

애플리케이션의 설계 대상인 DirectInput 의 버전 번호. 이 값은 보통, DIRECTINPUT_VERSION 이다. 이전의 버전 번호를 건네주면 DirectInput 가 그 버전을 에뮬레이트 한다.

반환값

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

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

DIERR_BETADIRECTINPUTVERSION	애플리케이션은, DirectInput 의 지원되지 않은 릴리스전의 버전용으로 생성 된 것이다.
DIERR_OLDDIRECTINPUTVERSION	애플리케이션은, 보다 새로운 버전의 DirectInput 를 필요로 한다.