IDirectInputJoyConfig8::OpenTypeKey-Methode (dinputd.h)

Artikel
02/28/2024

Die IDirectInputJoyConfig8::OpenTypeKey-Methode öffnet den Registrierungsschlüssel, der einem Joysticktyp zugeordnet ist.

Syntax

HRESULT OpenTypeKey(
  LPCWSTR unnamedParam1,
  DWORD   unnamedParam2,
  PHKEY   unnamedParam3
);

Parameter

unnamedParam1

Zeigt auf den Namen des Typs. Der Name des Typs darf MAX_PATH Zeichen, einschließlich des abschließenden NULL-Zeichens, nicht überschreiten. Der Name darf nicht mit einem "#"-Zeichen beginnen. Typen, die mit "#" beginnen, werden von DirectInput reserviert.

unnamedParam2

Gibt eine Zugriffsmaske für die Registrierungssicherheit an. Dies kann jeder der Werte sein, die von der RegOpenKeyEx-Funktion zulässig sind. Wenn Schreibzugriff angefordert wird, muss zuerst die Joystickkonfiguration abgerufen worden sein. Wenn nur Lesezugriff angefordert wird, ist kein Erwerb erforderlich.

unnamedParam3

Zeigt bei Erfolg auf den geöffneten Registrierungsschlüssel.

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 einen Joysticktypkonfigurationsschlüssel zum Schreiben öffnen können.
DIERR_INVALIDPARAM	Mindestens ein Parameter war ungültig.
MAKE_HRESULT(SEVERITY_ERROR, FACILITY_WIN32, ErrorCode)	Ein Win32-Fehlercode, wenn der Zugriff auf den Schlüssel durch Registrierungsberechtigungen oder einen anderen externen Faktor verweigert wird.

Hinweise

Systemsteuerungsanwendungen können den von dieser Methode geöffneten Registrierungsschlüssel verwenden, um persistente Informationen pro Typ zu speichern, z. B. globale Konfigurationsparameter. Solche privaten Informationen sollten in einem Unterschlüssel namens OEM aufbewahrt werden; speichern Sie keine privaten Informationen im schlüssel vom Typ Standard. Systemsteuerungsanwendungen können diesen Schlüssel auch verwenden, um Konfigurationsinformationen zu lesen, z. B. die Zeichenfolgen, die für Gerätekalibrierungsaufforderungen verwendet werden sollen. Die Anwendung sollte RegCloseKey verwenden, um den Registrierungsschlüssel zu schließen.

Anforderungen

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

Freigeben über