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

Article
01/10/2024

La méthode IDirectInputJoyConfig8 ::SetTypeInfo crée un nouveau type de joystick ou redéfinit les informations relatives à un type de joystick existant.

Syntaxe

HRESULT SetTypeInfo(
  LPCWSTR          unnamedParam1,
  LPCDIJOYTYPEINFO unnamedParam2,
  DWORD            unnamedParam3,
  LPWSTR           unnamedParam4
);

Paramètres

unnamedParam1

Pointe vers le nom du type. Le nom du type ne peut pas dépasser MAX_JOYSTRING caractères, y compris le caractère null de fin. Si le nom de type n’existe pas déjà, il est créé. Vous ne pouvez pas modifier les informations de type pour un type prédéfini. Le nom ne peut pas commencer par un caractère « # ». Les types commençant par « # » sont réservés par DirectInput.

unnamedParam2

Pointe vers une structure qui reçoit des informations sur le type de joystick.

unnamedParam3

Spécifie les parties de la structure DIJOYTYPEINFO pointées par pjti qui contiennent des valeurs à définir.

DITC_REGHWSETTINGS

Indique que les paramètres matériels du registre pour le joystick sont valides.

DITC_CLSIDCONFIG

Indique que le CLSID de configuration du joystick est valide. Si la valeur est toutes les zéros, il n’existe aucune configuration personnalisée pour ce type de joystick.

DITC_DISPLAYNAME

Indique que le nom d’affichage du type de manette de jeu est valide.

DITC_CALLOUT

Indique que la légende du type de manette de jeu est valide.

unnamedParam4

Si le nom de type est un type OEM qui n’est pas au format VID_xxxx&PID_yyyy, ce paramètre retourne le nom dans VID_xxxx&PID_yyyy format attribué par Dinput. Ce nom VID_xxxx&PID_yyyy doit être utilisé dans le champ DIJOYCONFIG.wszType lors de l’appel de SetConfig.

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 pour pouvoir informer les applications et les pilotes des modifications apportées à la configuration du joystick.
DIERR_INVALIDPARAM	Un ou plusieurs paramètres n’étaient pas valides.
DIERR_READONLY	Tentative de modification d’un type prédéfini.

Configuration requise


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

Partager via