IDirectInputJoyConfig8::Unacquire-Methode (dinputd.h)

Die IDirectInputJoyConfig8::Unacquire-Methode hebt den "Joystick-Konfigurationsmodus" auf.

Syntax

HRESULT Unacquire();

Rückgabewert

Gibt bei erfolgreicher Ausführung DI_OK zurück. Gibt andernfalls einen COM-Fehlercode zurück.

Hinweise

Bevor der Konfigurationsmodus deaktiviert wird, führt die Anwendung eine IDirectInputJoyConfig8::SendNotify aus, um die Änderungen in der Joystickkonfiguration an alle Gerätetreiber und Anwendungen weiterzuverbreiten. Anwendungen, die Schnittstellen zu einem Joystick enthalten, der wesentlich von einer Änderung der Konfiguration betroffen ist, sollten den DIERR_DEVICECHANGE Fehlercode erhalten, bis das Gerät neu initialisiert wird. Beispiele für wesentliche Änderungen an der Konfiguration sind das Ändern der Anzahl von Achsen oder der Anzahl von Schaltflächen. Im Vergleich dazu werden Änderungen an der Gerätekalibrierung intern von DirectInput verarbeitet und sind für die Anwendung transparent.

Anforderungen

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