Skip to main content

IGameInput::UnregisterCallback

Remove um método de retorno de chamada. O método não será mais chamado, e você poderá remover recursos da função de retorno de chamada após a conclusão de UnregisterCallback.

Sintaxe

Parâmetros

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

Valor retornado

Tipo: bool True se o registro do retorno de chamada foi cancelado com êxito.

Comentários

O método IGameInput::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 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. O exemplo de C++ a seguir demonstra como ser notificado quando um gamepad ou teclado é desconectado. 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