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++ 샘플은 연결된 게임패드와 키보드를 명시적으로 열거하는 방법을 보여줍니다.요구 사항
Input API 개요IGameInput
IGameInput::UnregisterCallback
IGameInput::StopCallback
