IDirectInputDevice8::GetObjectInfo 메서드

버튼이나 축등의 장치 개체의 정보를 얻어온다.

구문

HRESULT GetObjectInfo(      

    LPDIDEVICEOBJECTINSTANCE pdidoi,
    DWORD dwObj,
    DWORD dwHow
);

파라미터

pdidoi

개체의 정보를 저장 하는 DIDEVICEOBJECTINSTANCE 구조체의 주소. 이 구조체의 dwSize 멤버는, 이 메서드를 호출하기 전에 초기화해 두지 않으면 안 된다.

dwObj

얻어온다 정보가 소속하는 개체를 식별하는 값. 이 파라미터로 설정하는 값은,dwHow 파라미터로 지정되고 있는 값에 의존한다.

dwHow

dwObj 파라미터의 해석 방법을 지정하는 값. dwHow 에는, 다음의 몇개의 값을 지정할 수 있다.

DIPH_BYOFFSET

dwObj 파라미터는, 액세스 하는 정보가 소속하는 개체의 현재의 데이터 형식에 대한 오프셋(offset)이다.

DIPH_BYID

dwObj 파라미터는, 개체의 형태 또는 인스턴스 식별자이다. 이 식별자는,IDirectInputDevice8::EnumObjects 메서드를 전회 호출했을 때의 반환값인 DIDEVICEOBJECTINSTANCE 구조체의 dwType 멤버에 반환된다.

DIPH_BYUSAGE

dwObj 파라미터는, 개체의 "HID 사용 페이지" 와 "사용 상황" 의 값이다. 이러한 값은 DIMAKEUSAGEDWORD 매크로에 의해 조합할 수 있다.

반환값

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

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

DIERR_INVALIDPARAM	무효인 파라미터가, 돌아오는 함수에 건네졌는지, 개체가 그 함수를 호출할 수 있는 상태에 없었다. 이 값은, 표준의 구성 요소 개체 모델 (COM) 반환값인 E_INVALIDARG 에 동일하다.
DIERR_NOTINITIALIZED	이 개체는 초기화되지 않다.
DIERR_OBJECTNOTFOUND	요구된 개체는 존재하지 않는다.
E_POINTER	무효인 포인터 (보통은 NULL)가 파라미터로서 건네받았다.

주의

Microsoft® DirectX® 3 과의 호환성이 필요한 경우는,sizeof(DIDEVICEOBJECTINSTANCE_DX3) 에 초기화한 dwSize 멤버를 포함한 DIDEVICEOBJECTINSTANCE_DX3 구조체를 건네주어도 괜찮다.