Pular para o conteúdo principal
Preterido. Este método foi removido no GameInput v4 e não está disponível na API atual. Em vez disso, use IGameInput::UnregisterCallback, que, na v4, pode ser chamado com segurança de dentro de um retorno de chamada.
Impede que uma função de retorno de chamada seja disparada.

Sintaxe

Parâmetros

callbackToken   _In_
Tipo: GameInputCallbackToken
Token da função de retorno de chamada a ser interrompida. Gerado quando a função foi inicialmente registrada com IGameInput::RegisterDeviceCallback.

Valor retornado

Tipo: void Nenhum valor retornado.

Comentários

Esta função difere da função IGameInput::UnregisterCallback porque não torna seguro remover recursos da função de retorno de chamada; no entanto, ela pode ser chamada de dentro da função de retorno de chamada. O método StopCallback e o método IGameInput::UnregisterCallback diferem ligeiramente. Chamar qualquer um dos métodos garante que o retorno de chamada associado não será despachado novamente. No entanto, não é seguro liberar nenhum recurso associado ao retorno de chamada (por exemplo, descarregar a DLL que hospeda a função de retorno de chamada) até que a função IGameInput::UnregisterCallback retorne com êxito. Portanto, não é possível cancelar o registro de um retorno de chamada de dentro de sua função de retorno de chamada registrada, e tentar fazer isso disparará uma declaração fatal. No entanto, é seguro cancelar um retorno de chamada de dentro da função de retorno de chamada.

Requisitos

Cabeçalho: GameInput.h

Confira também

Membros preteridos da API GameInput
Visão geral da API de entrada
IGameInput
IGameInput::RegisterDeviceCallback
IGameInput::RegisterReadingCallback
IGameInput::RegisterSystemButtonCallback
IGameInput::UnregisterCallback

Histórico de versões

Última modificação em 6 de novembro de 2026