Pular para o conteúdo principal

Método IXtfInputClient::ConnectGamepad

Cria um controle virtual e obtém o identificador de dispositivo dele.

Sintaxe

Parâmetros

pControllerId
Tipo: UINT64 *
Ponteiro para um UINT64 que recebe o identificador de dispositivo deste IXtfInputClient.

Valor retornado

Tipo: HRESULT Código de êxito ou de erro HRESULT.

Comentários

ConnectGamepad aloca recursos do sistema para cada controle virtual criado, além de retornar o identificador do controle virtual que será usado para enviar entrada a um console de desenvolvimento com IXtfInputClient::SendGamepadReport. Seu código deve aguardar 2 segundos após chamar ConnectGamepad antes de chamar SendGamepadReport, para garantir que o console tenha concluído o registro do novo controle e esteja pronto para aceitar entrada. Seu código deve sempre emparelhar uma chamada a ConnectGamepad com uma chamada a DisconnectGamepad para garantir que esses recursos do sistema sejam liberados para reutilização. Você também pode chamar IXtfInputClient::DisconnectAllGamepads para liberar todos os recursos de controles virtuais de uma só vez.

Requisitos

Cabeçalho: xtfinput.h Biblioteca: xtfinput.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)

Confira também

XtfInput
IXtfInputClient
IXtfInputClient::ConnectGamepad
IXtfInputClient::DisconnectGamepad
IXtfInputClient::DisconnectAllGamepads
Última modificação em 6 de outubro de 2026