Skip to main content

IGameInput::StopCallback

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 registrada inicialmente com IGameInput::RegisterDeviceCallback.

Valor retornado

Tipo: void Nenhum valor retornado.

Comentários

Essa 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 Visão geral da API de entrada
IGameInput
IGameInput::RegisterDeviceCallback
IGameInput::RegisterReadingCallback
IGameInput::RegisterSystemButtonCallback

Histórico de versões

Last modified on October 6, 2026