IDirectInputJoyConfig8::GetConfig-Methode (dinputd.h)

Artikel
03/04/2024

Die IDirectInputJoyConfig8::GetConfig-Methode ruft Informationen zur Konfiguration eines Joysticks ab.

Syntax

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

Parameter

unnamedParam1

Gibt eine Joystick-Identifikationsnummer an. Dies ist eine nicht negative ganze Zahl. Um Joysticks aufzuzählen, beginnen Sie mit Joystick null und erhöhen die Joysticknummer um eins, bis die Funktion DIERR_NOMOREITEMS zurückgibt.

unnamedParam2

Zeigt auf eine Struktur, die Informationen zur Joystickkonfiguration empfängt. Der Aufrufer muss das dwSize-Element der DIJOYCONFIG-Struktur initialisieren, bevor er diese Methode aufruft.

unnamedParam3

Gibt die Elemente der Struktur an, auf die pjc verweist, die ausgefüllt werden sollen. Dieser Parameter kann null, eins oder mehrere der folgenden Parameter sein:

DIJC_GUIDINSTANCE

Gibt an, dass die instance GUID für den Joystick angefordert wird. Eine Anwendung kann die instance GUID an IDirectInput::CreateDevice übergeben, um eine IDirectInputDevice-Schnittstelle an den Joystick abzurufen. Beachten Sie, dass dieses Flag kein gültiger Parameter für IDirectInputJoyConfig8::SetConfig ist.

DIJC_REGHWCONFIGTYPE

Gibt an, dass die Hardwarekonfiguration für den Joystick (das hwc-Element der DIJOYCONFIG-Struktur) und der Joysticktypname (das wszType-Element derselben Struktur) angefordert werden. Beachten Sie, dass die Hardwarekonfiguration und der Typname nicht separat abgerufen werden können.

DIJC_GAIN

Gibt an, dass der Force-Feedback-Gain für den Joystick angefordert wird.

DIJC_CALLOUT

Gibt an, dass die Joystick-Abfrage-Legende angefordert wird.

Rückgabewert

Gibt bei erfolgreicher Ausführung DI_OK zurück. gibt andernfalls einen der folgenden COM-Fehlerwerte zurück:

Rückgabecode	Beschreibung
DIERR_INVALIDPARAM	Mindestens ein Parameter war ungültig.
S_FALSE	Der angegebene Joystick wurde noch nicht konfiguriert.
DIERR_NOMOREITEMS	Es sind keine Joysticks mehr verfügbar.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dinputd.h (include Dinputd.h)

Freigeben über