IDirectInput8::EnumDevicesBySemantics 메서드

애플리케이션 지정의 액션 맵에 가장 일치하는 장치를 열거한다.

구문

HRESULT EnumDevicesBySemantics(      

    LPCTSTR ptszUserName,
    LPDIACTIONFORMAT lpdiActionFormat,
    LPDIENUMDEVICESBYSEMANTICSCB lpCallback,
    LPVOID pvRef,
    DWORD dwFlags
);

파라미터

ptszUserName

현재의 사용자를 식별하는 캐릭터 라인. 시스템에 로그 온 한 사용자를 지정하는 경우는 NULL. 사용자명은 장치의 열거시에 고려된다. 사용자 맵핑이 없는 장치보다, 사용자 맵핑을 가지는 장치가 우선된다. 디폴트에서는, 다른 사용자가 사용중의 장치는, 이 사용자용으로는 열거되지 않는다.

lpdiActionFormat

열거하는 적절한 장치의 액션 맵을 지정하는 DIACTIONFORMAT 구조체의 주소.

lpCallback

열거되는 장치 마다 1 회 불려 가는 콜백 함수의 주소. 「DIEnumDevicesBySemanticsCallback 」를 참조할것.

pvRef

애플리케이션 정의의 32 비트값. 열거 콜백 함수가 불려 갈 때마다 건네받는다.

dwFlags

열거의 범위를 지정하는 플래그값. 다음의 1 개 또는 복수의 플래그를 지정한다.

DIEDBSFL_ATTACHEDONLY

Attach 상태에 있어, 인스톨 끝난 장치만을 열거한다.

DIEDBSFL_AVAILABLEDEVICES

미소유 또한 인스톨 끝난 장치만을 열거한다.

DIEDBSFL_FORCEFEEDBACK

force feedback를 지원 하는 장치만을 열거한다.

DIEDBSFL_MULTIMICEKEYBOARDS

2차 (비시스템) 키보드 및 마우스 장치만.

DIEDBSFL_NONGAMINGDEVICES

주된 용도가 게임 장치로서가 아닌, HID 준거의 장치만. USB 스피커등의 장치, 및 특수한 키보드의 멀티미디어 버튼은, 이 값을 취한다.

DIEDBSFL_THISUSER

ptszUserName 로 식별되는 사용자용의 인스톨 끝난 모든 장치, 및 미소유의 모든 장치를 열거한다.

DIEDBSFL_VALID

DIEDBSFL_VALID 도 Dinput.h 에 정의되고 있지만, 애플리케이션은 이것을 사용하지 않는다.

반환값

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

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

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

주의

키보드와 마우스는 마지막에 열거된다.

주  Microsoft® DirectInput® 가 장치를 열거하는 순서는 보증되지 않는다.

참조

IDirectInput8::EnumDevices ,액션 맵