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

  • Article

La méthode IDirectInputJoyConfig8 ::EnumTypes énumère les types de joysticks actuellement pris en charge par DirectInput. Un type de manette de jeu décrit comment DirectInput doit communiquer avec un dispositif de manette de jeu. Il inclut des informations telles que la présence et l’emplacement de chacun des axes et le nombre de boutons pris en charge par l’appareil.

Syntaxe

HRESULT EnumTypes(
  LPDIJOYTYPECALLBACK unnamedParam1,
  LPVOID              unnamedParam2
);

Paramètres

unnamedParam1

Pointe vers une fonction de rappel définie par l’application qui reçoit les types de joystick DirectInput. Consultez la section Remarques pour le prototype de fonction.

unnamedParam2

Spécifie une valeur 32 bits définie par l’application à passer à la fonction de rappel. Cette valeur peut être n’importe quelle valeur 32 bits ; il est prototype en tant que LPVOID pour des raisons pratiques.

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.

Remarques

Ce rappel reçoit les types de joysticks DirectInput à la suite d’un appel à la méthode IDirectInputJoyConfig8 ::EnumTypes.



/*
Parameters
pwszTypeName 
Points to the name of the joystick type. A buffer of MAX_JOYSTRING characters is sufficient to hold the type name. The type name should never be shown to the end user; instead, the "display name" should be shown. Use IDirectInputJoyConfig8::GetTypeInfo to obtain the display name of a joystick type. Type names that begin with a pound sign ("#") represent predefined types that cannot be modified or deleted. 

pvRef 
Points to the application-defined value given in the IDirectInputJoyConfig8::EnumTypes method.

Return value
Returns a BOOL value, DIENUM_CONTINUE, to continue the enumeration, or DIENUM_STOP to stop the enumeration. 

*/


BOOL DIEnumJoyTypeProc(
   LPCWSTR pwszTypeName,
   LPVOID  pvRef
);

Configuration requise

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