Metodo IDirectInputJoyConfig8::EnumTypes (dinputd.h)

Articolo
03/05/2024

Il metodo IDirectInputJoyConfig8::EnumTypes enumera i tipi di joystick attualmente supportati da DirectInput. Un tipo di joystick descrive come DirectInput deve comunicare con un dispositivo joystick. Include informazioni quali la presenza e la posizione di ognuno degli assi e il numero di pulsanti supportati dal dispositivo.

Sintassi

HRESULT EnumTypes(
  LPDIJOYTYPECALLBACK unnamedParam1,
  LPVOID              unnamedParam2
);

Parametri

unnamedParam1

Punta a una funzione di callback definita dall'applicazione che riceve i tipi di joystick DirectInput. Vedere la sezione Osservazioni per il prototipo di funzione.

unnamedParam2

Specifica un valore definito dall'applicazione a 32 bit da passare alla funzione di callback. Questo valore può essere qualsiasi valore a 32 bit; viene prototipo come LPVOID per praticità.

Valore restituito

Restituisce DI_OK se ha esito positivo; in caso contrario, restituisce uno dei valori di errore COM seguenti:

Codice restituito	Descrizione
DIERR_INVALIDPARAM	Uno o più parametri non sono validi.

Commenti

Questo callback riceve i tipi di joystick DirectInput come risultato di una chiamata al metodo 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
);

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dinputd.h (include Dinputd.h)

Condividi tramite