IDirectInputJoyConfig8::SetTypeInfo-Methode (dinputd.h)

Artikel
08/23/2023

Die IDirectInputJoyConfig8::SetTypeInfo-Methode erstellt einen neuen Joysticktyp oder definiert Informationen zu einem vorhandenen Joysticktyp neu.

Syntax

HRESULT SetTypeInfo(
  LPCWSTR          unnamedParam1,
  LPCDIJOYTYPEINFO unnamedParam2,
  DWORD            unnamedParam3,
  LPWSTR           unnamedParam4
);

Parameter

unnamedParam1

Zeigt auf den Namen des Typs. Der Name des Typs darf MAX_JOYSTRING Zeichen, einschließlich des beendenden NULL-Zeichens, nicht überschreiten. Wenn der Typname noch nicht vorhanden ist, wird er erstellt. Sie können die Typinformationen für einen vordefinierten Typ nicht ändern. Der Name darf nicht mit einem "#"-Zeichen beginnen. Typen, die mit "#" beginnen, werden von DirectInput reserviert.

unnamedParam2

Zeigt auf eine Struktur, die Informationen zum Joysticktyp empfängt.

unnamedParam3

Gibt die Teile der DIJOYTYPEINFO-Struktur an, auf die von pjti verwiesen wird, die festzulegende Werte enthalten.

DITC_REGHWSETTINGS

Gibt an, dass die Registrierungshardwareeinstellungen für den Joystick gültig sind.

DITC_CLSIDCONFIG

Gibt an, dass die CLSID für die Joystickkonfiguration gültig ist. Wenn der Wert alle Nullen ist, gibt es keine benutzerdefinierte Konfiguration für diesen Joysticktyp.

DITC_DISPLAYNAME

Gibt an, dass der Anzeigename für den Joysticktyp gültig ist.

DITC_CALLOUT

Gibt an, dass die Beschriftung für den Joysticktyp gültig ist.

unnamedParam4

Wenn der Typname ein OEM-Typ ist, der sich nicht im VID_xxxx&PID_yyyy Format befindet, gibt dieser Parameter den Namen in VID_xxxx&PID_yyyy Format zurück, das von Dinput zugewiesen wird. Dieser VID_xxxx&PID_yyyy Name sollte beim Aufrufen von SetConfig im Feld DIJOYCONFIG.wszType verwendet werden.

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.
DIERR_READONLY	Es wurde versucht, einen vordefinierten Typ zu ändern.

Anforderungen


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

Freigeben über