Skip to main content

IGameInput::RegisterSystemButtonCallback

Inscrit une fonction de rappel appelée lorsque le bouton Guide ou Partager est enfoncé ou relâché.

Syntaxe

Paramètres

device   _In_opt_
Type : IGameInputDevice*
Limite facultativement le rappel inscrit afin qu’il se déclenche pour un appareil spécifique. buttonFilter   _In_
Type : GameInputSystemButtons
L’ensemble des boutons pour lesquels recevoir des rappels, combinés par un OU logique. context   _In_opt_
Type : void*
Un objet qui fournit des renseignements pertinents pour la fonction de rappel. Il s’agit généralement de l’objet appelant. callbackFunc   _In_
Type : GameInputSystemButtonCallback
Fonction de rappel définie par le titre, appelée lorsque les boutons système sont enfoncés ou relâchés. callbackToken   _Out_opt_
Type : GameInputCallbackToken*
Jeton identifiant la fonction de rappel inscrite. Ce jeton sert à identifier la fonction inscrite si vous devez annuler ou désinscrire la fonction de rappel.

Valeur de retour

Type : HRESULT Résultat de la fonction.

Remarques

Cette méthode inscrit un appel de fonction de rappel lorsque le bouton Guide ou Système est enfoncé ou relâché. La distribution des rappels dépend de la stratégie GameInputFocusPolicy définie par IGameInput::SetFocusPolicy dans votre processus et dans d’autres processus. Pour plus de détails, consultez GameInputFocusPolicy. Sur la XBOX, l’interpréteur de commandes consomme toujours le bouton Guide; ces rappels ne sont donc jamais distribués sur XBOX. Pour cesser de recevoir des rappels, consultez les méthodes IGameInput::UnregisterCallback et IGameInput::StopCallback. Cette méthode a été ajoutée dans le fichier GameInput.h de la préversion 10.0.26031 du SDK Windows et sera ajoutée dans une version future du GDK. L’exemple de code suivant montre comment détecter les appuis sur le bouton Guide.

Configuration requise

En-tête : GameInput.h Bibliothèque : gameinput.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

Rubriques avancées sur GameInput
Vue d’ensemble de GameInput
IGameInput

Historique des versions

Last modified on October 6, 2026