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

Article
02/26/2024

La méthode IDirectInputJoyConfig8 ::GetConfig obtient des informations sur la configuration d’un joystick.

Syntaxe

HRESULT GetConfig(
  UINT          unnamedParam1,
  LPDIJOYCONFIG unnamedParam2,
  DWORD         unnamedParam3
);

Paramètres

unnamedParam1

Indique un numéro d’identification de la manette de jeu. Il s’agit d’un entier non négatif. Pour énumérer les manettes de jeu, commencez par zéro de la manette de jeu et incrémentez le numéro de la manette de jeu d’un jusqu’à ce que la fonction retourne DIERR_NOMOREITEMS.

unnamedParam2

Pointe vers une structure qui reçoit des informations sur la configuration du joystick. L’appelant « doit » initialiser le membre dwSize de la structure DIJOYCONFIG avant d’appeler cette méthode.

unnamedParam3

Spécifie les membres de la structure pointées par pjc qui doivent être renseignés. Ce paramètre peut être égal à zéro, un ou plusieurs des éléments suivants :

DIJC_GUIDINSTANCE

Indique que le GUID instance du joystick est demandé. Une application peut passer le GUID instance à IDirectInput ::CreateDevice pour obtenir une interface IDirectInputDevice au joystick. Notez que cet indicateur n’est pas un paramètre valide pour IDirectInputJoyConfig8 ::SetConfig.

DIJC_REGHWCONFIGTYPE

Indique que la configuration matérielle du joystick (membre hwc de la structure DIJOYCONFIG) et le nom du type de manette (membre wszType de la même structure) sont demandés. Notez que la configuration matérielle et le nom du type ne peuvent pas être récupérés séparément.

DIJC_GAIN

Indique que le gain de retour de force pour le joystick est demandé.

DIJC_CALLOUT

Indique que la légende d’interrogation du joystick est demandée.

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_INVALIDPARAM	Un ou plusieurs paramètres n’étaient pas valides.
S_FALSE	Le joystick spécifié n’a pas encore été configuré.
DIERR_NOMOREITEMS	Il n’y a plus de manettes de jeu disponibles.

Configuration requise

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

Partager via