Skip to main content

IGameInput::RegisterDeviceCallback

장치가 시스템에 연결되거나 시스템에서 연결이 끊길 때마다 호출되는 GameInputDeviceCallback 함수를 등록합니다. 또한 장치 속성이 변경될 때 이 함수가 호출되도록 허용합니다.

구문

매개변수

device   _In_opt_
형식: IGameInputDevice*
등록된 콜백이 특정 장치에 대해서만 트리거되도록 제한합니다. inputKind   _In_
형식: GameInputKind
지정된 입력 유형 중 적어도 하나를 지원하는 장치에 대해서만 등록된 콜백이 트리거되도록 제한합니다. statusFilter   _In_
형식: GameInputDeviceStatus
특정 유형의 장치 상태 변경에 대해서만 등록된 콜백이 트리거되도록 제한합니다. enumerationKind   _In_
형식: GameInputEnumerationKind
장치가 열거될지 여부와 함수가 열거 완료를 기다릴지 여부를 결정합니다. context   _In_opt_
형식: void*
콜백 함수에 관련된 정보를 제공하는 개체입니다. 일반적으로 호출 개체입니다. callbackFunc   _In_
형식: GameInputDeviceCallback
장치 연결 또는 연결 해제 이벤트에 대해 등록할 타이틀 정의 콜백입니다. callbackToken   _Result_zeroonfailure_
형식: GameInputCallbackToken*
등록된 콜백 함수를 식별하는 토큰입니다. 이 토큰은 콜백 함수를 취소하거나 등록 해제해야 하는 경우 등록된 함수를 식별하는 데 사용됩니다.

반환값

형식: HRESULT 함수 결과.

설명

IGameInput::RegisterDeviceCallback로 등록된 함수는 연결 또는 연결 해제와 같은 장치 상태의 변경에 반응하는 데 사용될 수 있습니다. 인식 가능한 상태 변경 유형은 GameInputDeviceStatus에 나열되어 있습니다. enumerationKind 매개변수는 시스템에 연결된 각 장치에 대해 하나씩, 초기 콜백 세례가 생성되도록 하는 데 사용될 수 있습니다. 이 초기 열거는 비동기 또는 동기 열거로 설정할 수 있습니다. 동기 열거는 IGameInput::RegisterDeviceCallback이 반환되기 전에 모든 초기 콜백을 호출합니다. 다음 C++ 샘플은 연결된 게임패드와 키보드를 명시적으로 열거하는 방법을 보여줍니다.
다음 C++ 샘플은 장치가 연결되거나 연결이 끊길 때 알림을 받는 방법을 보여줍니다.

요구 사항

Input API 개요
IGameInput
IGameInput::UnregisterCallback
IGameInput::StopCallback

버전 기록

마지막 수정일 2026년 8월 13일