IDirectInputJoyConfig8::Acquire-Methode (dinputd.h)

  • Artikel

Die IDirectInputJoyConfig8::Acquire-Methode ruft den "Joystick-Konfigurationsmodus" ab. Nur eine Anwendung kann sich gleichzeitig im Joystick-Konfigurationsmodus befinden. nachfolgende Versuche anderer Anwendungen, diesen Modus zu erwerben, sollten den Fehler DIERR_OTHERAPPHASPRIO erhalten. Nach dem Wechsel in den Konfigurationsmodus kann die Anwendung Änderungen an den globalen Joystickkonfigurationseinstellungen vornehmen. Die Anwendung sollte die vorhandenen Einstellungen überprüfen, bevor sie die neuen Einstellungen installiert, falls eine andere Anwendung die Einstellungen in der Zwischenzeit geändert hat.

Syntax

HRESULT Acquire();

Rückgabewert

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

Rückgabecode Beschreibung
DIERR_OTHERAPPHASPRIO
Eine andere Anwendung befindet sich bereits im Joystick-Konfigurationsmodus.
DIERR_INSUFFICIENTPRIVS
Der aktuelle Benutzer verfügt nicht über die erforderlichen Berechtigungen, um die Joystickkonfiguration zu ändern.
DIERR_DEVICECHANGE
Eine andere Anwendung hat die globale Joystickkonfiguration geändert. Die Schnittstelle muss neu initialisiert werden.

Anforderungen

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