Partager via


IDirectInputJoyConfig8 ::Acquire, méthode (dinputd.h)

La méthode IDirectInputJoyConfig8 ::Acquire acquiert le « mode de configuration du joystick ». Une seule application peut être en mode de configuration du joystick à la fois ; Les tentatives suivantes d’autres applications d’acquérir ce mode doivent recevoir l’erreur DIERR_OTHERAPPHASPRIO. Après avoir entré le mode de configuration, l’application peut apporter des modifications aux paramètres de configuration globaux du joystick. L’application doit case activée les paramètres existants avant d’installer les nouveaux au cas où une autre application modifie les paramètres entre-temps.

Syntaxe

HRESULT Acquire();

Valeur de retour

Retourne DI_OK en cas de réussite ; sinon, retourne l’une des valeurs d’erreur COM suivantes :

Code de retour Description
DIERR_OTHERAPPHASPRIO
Une autre application est déjà en mode de configuration du joystick.
DIERR_INSUFFICIENTPRIVS
L’utilisateur actuel ne dispose pas des autorisations nécessaires pour modifier la configuration du joystick.
DIERR_DEVICECHANGE
Une autre application a modifié la configuration globale du joystick. L’interface doit être réinitialisée.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dinputd.h (inclure Dinputd.h)