Freigeben über


IDirectInputJoyConfig8::OpenTypeKey-Methode (dinputd.h)

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)