Edit

Share via

IDirectInputJoyConfig8::Unacquire method (dinputd.h)

  • Article

The IDirectInputJoyConfig8::Unacquire method unacquires "joystick configuration mode".

Syntax

HRESULT Unacquire();

Return value

Returns DI_OK if successful; otherwise, returns a COM error code.

Remarks

Before unacquiring configuration mode, the application performs an IDirectInputJoyConfig8::SendNotify to propagate the changes in the joystick configuration to all device drivers and applications. Applications that hold interfaces to a joystick that is materially affected by a change in configuration should receive the DIERR_DEVICECHANGE error code until the device is reinitialized. Examples of material changes to configuration include altering the number of axes or the number of buttons. In comparison, changes to device calibration are handled internally by DirectInput and are transparent to the application.

Requirements

Requirement Value
Target Platform Desktop
Header dinputd.h (include Dinputd.h)