Condividi tramite


Metodo IDirectInputJoyConfig8::Acquire (dinputd.h)

Il metodo IDirectInputJoyConfig8::Acquire acquisisce "modalità di configurazione joystick". Solo un'applicazione può essere in modalità di configurazione joystick alla volta; i successivi tentativi da parte di altre applicazioni di acquisire questa modalità devono ricevere l'errore DIERR_OTHERAPPHASPRIO. Dopo aver immesso la modalità di configurazione, l'applicazione può apportare modifiche alle impostazioni di configurazione del joystick globale. L'applicazione deve controllare le impostazioni esistenti prima di installare quelle nuove nel caso in cui un'altra applicazione ha modificato le impostazioni nel frattempo.

Sintassi

HRESULT Acquire();

Valore restituito

Restituisce DI_OK in caso di esito positivo; in caso contrario, restituisce uno dei valori di errore COM seguenti:

Codice restituito Descrizione
DIERR_OTHERAPPHASPRIO
Un'altra applicazione è già in modalità di configurazione joystick.
DIERR_INSUFFICIENTPRIVS
L'utente corrente non dispone delle autorizzazioni necessarie per modificare la configurazione del joystick.
DIERR_DEVICECHANGE
Un'altra applicazione ha modificato la configurazione globale del joystick. L'interfaccia deve essere reinizializzata.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione dinputd.h (include Dinputd.h)