Skip to main content

IXtfInputClient::ConnectGamepad (método)

Crea un mando virtual y obtiene su identificador de dispositivo.

Sintaxis

Parámetros

pControllerId
Tipo: UINT64 *
Puntero a un UINT64 que recibe el identificador de dispositivo de este IXtfInputClient.

Valor devuelto

Tipo: HRESULT Código de éxito o de error HRESULT.

Comentarios

ConnectGamepad asigna recursos del sistema para cada mando virtual creado y devuelve el identificador del mando virtual que se usará para enviar entradas a una consola de desarrollo con IXtfInputClient::SendGamepadReport. El código debe esperar 2 segundos después de llamar a ConnectGamepad antes de llamar a SendGamepadReport, para garantizar que la consola haya terminado de registrar el nuevo mando y esté lista para aceptar entradas. El código siempre debe emparejar una llamada a ConnectGamepad con una llamada a DisconnectGamepad para garantizar que estos recursos del sistema se liberen para su reutilización. También puede llamar a IXtfInputClient::DisconnectAllGamepads para liberar todos los recursos de mandos virtuales a la vez.

Requisitos

Encabezado: xtfinput.h Biblioteca: xtfinput.lib Plataformas compatibles: Windows (para herramientas de consola XBOX)

Consulte también

XtfInput
IXtfInputClient
IXtfInputClient::ConnectGamepad
IXtfInputClient::DisconnectGamepad
IXtfInputClient::DisconnectAllGamepads
Última modificación el 28 de agosto de 2026