Share via

Método IDirectInputJoyConfig8::Acquire (dinputd.h)

  • Artículo

El método IDirectInputJoyConfig8::Acquire adquiere el "modo de configuración de joystick". Solo una aplicación puede estar en modo de configuración de joystick a la vez; los intentos posteriores de otras aplicaciones para adquirir este modo deben recibir el error DIERR_OTHERAPPHASPRIO. Después de entrar en el modo de configuración, la aplicación puede realizar modificaciones en los ajustes de configuración del joystick global. La aplicación debe comprobar la configuración existente antes de instalar las nuevas en caso de que otra aplicación cambie la configuración provisionalmente.

Sintaxis

HRESULT Acquire();

Valor devuelto

Devuelve DI_OK si se ejecuta correctamente; de lo contrario, devuelve uno de los siguientes valores de error COM:

Código devuelto Descripción
DIERR_OTHERAPPHASPRIO
Otra aplicación ya está en modo de configuración de joystick.
DIERR_INSUFFICIENTPRIVS
El usuario actual no tiene los permisos necesarios para modificar la configuración del joystick.
DIERR_DEVICECHANGE
Otra aplicación ha cambiado la configuración global del joystick. La interfaz debe reinicializarse.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dinputd.h (incluya Dinputd.h)