IGameInput::StopCallback

콜백 함수가 트리거되지 않도록 방지합니다.

구문

void StopCallback(  
         GameInputCallbackToken callbackToken  
)  

매개 변수

callbackToken _In_
형식: GameInputCallbackToken

등록을 취소할 콜백 함수에 대한 토큰입니다. 함수가 처음에 IGameInput::RegisterDeviceCallback으로 등록되었을 때 생성됩니다.

반환 값

형식: void

반환 값이 없습니다.

설명

이 함수는 콜백 함수에서 리소스를 제거하는 것을 안전하게 만들지 않지만, 콜백 함수로부터 호출될 수 있다는 점에서 해당 함수와 다릅니다.

StopCallback 메서드 및 IGameInput::UnregisterCallback 메서드는 약간 다릅니다. 어느 메서드를 호출해도 연결된 콜백이 다시 발송되지 않습니다. 하지만 IGameInput::UnregisterCallback 함수가 성공적으로 반환될 때까지는 콜백과 연결된 리소스를 해제하는 것이 안전하지 않습니다(예: 콜백 함수를 호스트하는 DLL 로드 해제). 따라서 등록된 콜백 함수 내에서 콜백을 등록 취소하는 것이 불가능하며, 이렇게 하려고 시도하면 오류가 반환됩니다. 하지만 콜백 함수 내에서 콜백을 취소하는 것은 안전합니다.

요구 사항

헤더: GameInput.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

입력 API 개요
IGameInput
IGameInput::RegisterDeviceCallback
IGameInput::RegisterReadingCallback
IGameInput::RegisterSystemButtonCallback