Méthode IDirectInputJoyConfig8 ::OpenTypeKey (dinputd.h)

  • Article

La méthode IDirectInputJoyConfig8 ::OpenTypeKey ouvre la clé de Registre associée à un type de joystick.

Syntaxe

HRESULT OpenTypeKey(
  LPCWSTR unnamedParam1,
  DWORD   unnamedParam2,
  PHKEY   unnamedParam3
);

Paramètres

unnamedParam1

Pointe vers le nom du type. Le nom du type ne peut pas dépasser MAX_PATH caractères, y compris le caractère null de fin. Le nom ne peut pas commencer par un caractère « # ». Les types commençant par « # » sont réservés par DirectInput.

unnamedParam2

Spécifie un masque d’accès de sécurité au Registre. Il peut s’agir de l’une des valeurs autorisées par la fonction RegOpenKeyEx . Si l’accès en écriture est demandé, la configuration du joystick doit d’abord avoir été acquise. Si seul l’accès en lecture est demandé, l’acquisition n’est pas nécessaire.

unnamedParam3

Pointe vers la clé de Registre ouverte, en cas de réussite.

Valeur retournée

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

Code de retour Description
DIERR_NOTACQUIRED
La configuration du joystick n’a pas été acquise. Vous devez appeler IDirectInputJoyConfig8 ::Acquire avant de pouvoir ouvrir une clé de configuration de type joystick pour l’écriture.
DIERR_INVALIDPARAM
Un ou plusieurs paramètres n’étaient pas valides.
MAKE_HRESULT(SEVERITY_ERROR, FACILITY_WIN32, ErrorCode)
Un code d’erreur Win32 si l’accès à la clé est refusé par les autorisations du Registre ou un autre facteur externe.

Remarques

Les applications du Panneau de configuration peuvent utiliser la clé de Registre ouverte par cette méthode pour stocker des informations persistantes par type, telles que des paramètres de configuration globale. Ces informations privées doivent être conservées dans une sous-clé nommée OEM ; ne stockez pas d’informations privées dans la clé de type main. Les applications du panneau de configuration peuvent également utiliser cette clé pour lire les informations de configuration, telles que les chaînes à utiliser pour les invites d’étalonnage des appareils. L’application doit utiliser RegCloseKey pour fermer la clé de Registre.

Configuration requise

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