IDirectInputJoyConfig8::SetUserValues-Methode (dinputd.h)

Artikel
03/01/2024

Die IDirectInputJoyConfig8::SetUserValues-Methode legt die Benutzereinstellungen für den Joystick fest.

Syntax

HRESULT SetUserValues(
  LPCDIJOYUSERVALUES unnamedParam1,
  DWORD              unnamedParam2
);

Parameter

unnamedParam1

Zeigt auf eine Struktur, die Informationen zu den neuen Einstellungen des Joysticks des Benutzers empfängt.

unnamedParam2

Gibt die Teile der DIJOYUSERVALUES-Struktur an , die festzulegende Werte enthalten. Es kann null, eins oder mehrere der folgenden Elemente geben:

DIJU_USERVALUES

Gibt an, dass die Benutzerkonfigurationseinstellungen (das ruv-Element der DIJOYUSERVALUES-Struktur) gültig sind.

DIJU_GLOBALDRIVER

Gibt an, dass der globale Porttreiber (das wszGlobalDriver-Element der DIJOYUSERVALUES-Struktur) gültig ist.

Eine Liste der gültigen globalen Treiber kann abgerufen werden, indem Sie die Liste der Joysticktypen auflisten. Wenn für den Joysticktyp das flag JOY_HWS_ISGAMEPORTDRIVER im dwFlags-Member der JOYHWSETTINGS-Struktur festgelegt ist, enthält das wszCallout-Element der DIJOYTYPEINFO-Struktur den Namen eines Treibers, der als globaler Treiber verwendet werden kann.

DIJU_GAMEPORTEMULATOR

Nicht verwendet.

Rückgabewert

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

Rückgabecode	Beschreibung
DIERR_NOTACQUIRED	Die Joystickkonfiguration wurde nicht abgerufen. Sie müssen IDirectInputJoyConfig8::Acquire aufrufen, bevor Sie Anwendungen und Treiber über Änderungen an der Joystickkonfiguration benachrichtigen können.
DIERR_INVALIDPARAM	Mindestens ein Parameter war ungültig.

Anforderungen

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

Freigeben über