Skip to main content

Méthode IXtfInputClient::ConnectGamepad

Crée une manette virtuelle et obtient son identificateur d’appareil.

Syntaxe

Paramètres

pControllerId
Type : UINT64 *
Pointeur vers un UINT64 qui reçoit l’identificateur d’appareil de cet objet IXtfInputClient.

Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT.

Remarques

ConnectGamepad alloue des ressources système pour chaque manette virtuelle créée et retourne l’identificateur de la manette virtuelle qui sera utilisé pour envoyer des entrées à une console de développement avec IXtfInputClient::SendGamepadReport. Votre code doit attendre 2 secondes après l’appel de ConnectGamepad avant d’appeler SendGamepadReport, afin de s’assurer que la console a terminé l’inscription de la nouvelle manette et est prête à accepter des entrées. Votre code doit toujours associer un appel à ConnectGamepad à un appel à DisconnectGamepad pour garantir que ces ressources système sont libérées en vue de leur réutilisation. Vous pouvez également appeler IXtfInputClient::DisconnectAllGamepads pour libérer toutes les ressources des manettes virtuelles en une seule fois.

Configuration requise

En-tête : xtfinput.h Bibliothèque : xtfinput.lib Plateformes prises en charge : Windows (pour les outils de console XBOX)

Voir aussi

XtfInput
IXtfInputClient
IXtfInputClient::ConnectGamepad
IXtfInputClient::DisconnectGamepad
IXtfInputClient::DisconnectAllGamepads
Last modified on October 6, 2026