IDirectInputDevice8::Initialize 메서드

DirectInputDevice 개체를 초기화한다. IDirectInput8::CreateDevice 메서드는, 장치의 생성 한 후에 자동적으로 장치를 초기화하므로, 보통, 애플리케이션은 이 메서드를 호출할 필요는 없다.

구문

HRESULT Initialize(      

    HINSTANCE hinst,
    DWORD dwVersion,
    REFGUID rguid
);

파라미터

hinst

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

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

dwVersion

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

rguid

C++ 의 경우, 인터페이스를 관련짓는 장치의 인스턴스를 식별하는 글로벌 일의 식별자 (GUID)에 대한 참조값. C 의 경우, 이 GUID 의 주소. IDirectInput8::EnumDevices 메서드를 사용하면 시스템이 어느 인스턴스 GUID 를 지원 하고 있는지를 확인할 수 있다.

반환값

성공했을 경우는, DI_OK 를 돌려준다. S_FALSE 를 돌려주는 경우는,rGUID 를 개입시켜 건네받은 인스턴스 GUID 를 가지는 장치는 초기화가 끝난 상태이다.

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

DIERR_ACQUIRED	조작은, 장치가 취득 상태의 사이는 실행할 수 없다.
DIERR_DEVICENOTREG	장치 또는 장치 인스턴스가 DirectInput 에 등록되지 않았다. 이 값은, 표준의 구성 요소 개체 모델 (COM) 반환값인 REGDB_E_CLASSNOTREG 에 동일하다.

주의

이 메서드가 실패하는 경우는, 기본으로 되는 개체는 부정 상태에 있는 것이라고 봐, 사용전에 재초기화해야 한다.