nf-dinputd-idirectinputjoyconfig8-acquire.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:dinputd.IDirectInputJoyConfig8.Acquire	IDirectInputJoyConfig8::Acquire (dinputd.h)	The IDirectInputJoyConfig8::Acquire method acquires "joystick configuration mode." Only one application can be in joystick configuration mode at a time; subsequent attempts by other applications to acquire this mode should receive the error DIERR_OTHERAPPHASPRIO. After entering configuration mode, the application can make alterations to the global joystick configuration settings. The application should check the existing settings before installing the new ones in case another application changed the settings in the interim.	Acquire Acquire method [Human Input Devices] Acquire method [Human Input Devices] IDirectInputJoyConfig8 interface IDirectInputJoyConfig8 interface [Human Input Devices] Acquire method IDirectInputJoyConfig8.Acquire IDirectInputJoyConfig8::Acquire di_ref_299a63df-4623-437b-b106-2e8c0530f462.xml dinputd/IDirectInputJoyConfig8::Acquire hid.idirectinputjoyconfig8_acquire	hid\idirectinputjoyconfig8_acquire.htm	hid	1df2eb92-9c55-4371-84c7-a4fb879efb7e	12/05/2018	Acquire, Acquire method [Human Input Devices], Acquire method [Human Input Devices],IDirectInputJoyConfig8 interface, IDirectInputJoyConfig8 interface [Human Input Devices],Acquire method, IDirectInputJoyConfig8.Acquire, IDirectInputJoyConfig8::Acquire, di_ref_299a63df-4623-437b-b106-2e8c0530f462.xml, dinputd/IDirectInputJoyConfig8::Acquire, hid.idirectinputjoyconfig8_acquire	dinputd.h	Dinputd.h	Desktop															Windows			19H1	IDirectInputJoyConfig8::Acquire dinputd/IDirectInputJoyConfig8::Acquire	c++	APIRef kbSyntax	COM	Dinputd.h	IDirectInputJoyConfig8.Acquire

IDirectInputJoyConfig8::Acquire

-description

The IDirectInputJoyConfig8::Acquire method acquires "joystick configuration mode." Only one application can be in joystick configuration mode at a time; subsequent attempts by other applications to acquire this mode should receive the error DIERR_OTHERAPPHASPRIO. After entering configuration mode, the application can make alterations to the global joystick configuration settings. The application should check the existing settings before installing the new ones in case another application changed the settings in the interim.

-returns

Returns DI_OK if successful; otherwise, returns one of the following COM error values:

Return code	Description
DIERR_OTHERAPPHASPRIO	Another application is already in joystick configuration mode.
DIERR_INSUFFICIENTPRIVS	The current user does not have the necessary permissions to alter the joystick configuration.
DIERR_DEVICECHANGE	Another application has changed the global joystick configuration. The interface needs to be reinitialized.