DIEnumDevicesBySemanticsCallback 함수

IDirectInput8::EnumDevicesBySemantics 메서드에 대한 호출 결과적으로 Microsoft® DirectInput® 장치를 받는, 애플리케이션 정의의 콜백 함수.

구문

BOOL CALLBACK DIEnumDevicesBySemanticsCallback(      

    LPCDIDEVICEINSTANCE lpddi,
    LPDIRECTINPUTDEVICE8 lpdid,
    DWORD dwFlags,
    DWORD dwRemaining,
    LPVOID pvRef
);

파라미터

lpddi

장치 인스턴스를 기술하는 DIDEVICEINSTANCE 구조체의 주소.

lpdid

장치의 IDirectInputDevice8 인터페이스의 포인터.

dwFlags

장치의 열거 이유에 관한 정보를 제공하는 플래그. 액션 맵핑 플래그의 편성이나, 1 개의 이용 플래그를 사용할 수 있다. 적어도 1 개의 액션 맵핑 플래그가 항상 존재한다.

이하에서는, DIEDBS_MAPPEDPRI1 및 DIEDBS_MAPPEDPRI2 액션 맵핑 플래그와 DIEDBS_RECENTDEVICE 및 DIEDBS_NEWDEVICE 이용 플래그에 대해 정의한다.

DIEDBS_MAPPEDPRI1

우선 순위 1 의 액션은 장치에 맵 되기 (위해)때문에, 장치가 열거된다.

DIEDBS_MAPPEDPRI2

우선 순위 2 의 액션은 장치에 맵 되기 (위해)때문에, 장치가 열거된다.

DIEDBS_RECENTDEVICE

액션 맵핑 플래그로 지정된 커멘드가 최근 사용되었기 때문에, 장치를 열거하고 있다.

DIEDBS_NEWDEVICE

장치가 최근 인스톨 되었기 때문에, 장치를 열거하고 있다. 이 플래그로 지정된 장치는, 이 게임에서는 지금까지 사용되지 않았다.

dwRemaining

이 장치의 뒤에 남아 있는 열거 대상의 장치수.

pvRef

IDirectInput8::EnumDevicesBySemantics 에 pvRef 파라미터로서 건네받는 애플리케이션 정의의 값.

반환값

열거를 속행하는 DIENUM_CONTINUE 를 돌려주는지, 열거를 정지하는 DIENUM_STOP 를 돌려준다.

주의

단일의 하드웨어 장치가, 복수의 DirectInput 장치 타입으로서 기능할 수가 있는 경우는, 지원 하는 각 장치 타입 마다 열거된다. 예를 들어, 편입 마우스 부착의 키보드는, 2 회 열거된다. 1 회는 1 개의 키보드로서 1 회는 1 개의 마우스로서 열거된다. 다만, 제품 글로벌 일의 식별자 (GUID)는 각 장치에 대해서 같다.

함수의 정보

헤더	dinput.h
임포트 라이브러리	없음
최저한의 operating system	Windows 98

참조

DIEnumDevicesCallback