IDirectInput8::FindDevice 메서드

시스템에 새롭고 Attach 된 장치의 인스턴스 글로벌 일의 식별자 (GUID)를 얻어온다. 이 메서드는, Microsoft® Win32® 장치 관리 통지에 응답해 호출된다.

구문

HRESULT FindDevice(      

    REFGUID rguidClass,
    LPCTSTR ptszName,
    LPGUID pguidInstance
);

파라미터

rguidClass

애플리케이션이 검색하는 장치의 장치 클래스의 일의의 식별자. 애플리케이션은, 장치 도착 통지로부터 클래스 GUID 를 얻어온다. 더 자세한 정보는, Microsoft Platform Software Development Kit (SDK)의 DBT_DEVICEARRIVAL 이벤트의 주제를 참조할것.

ptszName

장치의 이름. 애플리케이션은, 장치 도착 통지로부터 이름을 얻어온다.

pguidInstance

장치가 발견되었을 경우에 장치의 인스턴스 GUID 를 받는 변수의 주소. 이 값은 IDirectInput8::CreateDevice 에 건네줄 수가 있다.

반환값

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

실패했을 경우는,DIERR_DEVICENOTREG 를 돌려준다. GUID 와 이름이, Microsoft DirectInput® 에 등록되어 있는 장치 클래스에 대응하지 않는 경우는, 실패가 된다. 예를 들어, 입력 장치는 아니고, 기억 장치를 참조하는 경우 등이다.