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

  • Artigo

O método IDirectInputJoyConfig8::Acquire adquire o "modo de configuração do joystick". Somente um aplicativo pode estar no modo de configuração do joystick por vez; as tentativas subsequentes de outros aplicativos de adquirir esse modo devem receber o erro DIERR_OTHERAPPHASPRIO. Depois de entrar no modo de configuração, o aplicativo pode fazer alterações nas definições de configuração do joystick global. O aplicativo deve marcar as configurações existentes antes de instalar as novas caso outro aplicativo altere as configurações nesse ínterim.

Sintaxe

HRESULT Acquire();

Retornar valor

Retorna DI_OK se tiver êxito; caso contrário, retornará um dos seguintes valores de erro COM:

Código de retorno Descrição
DIERR_OTHERAPPHASPRIO
Outro aplicativo já está no modo de configuração do joystick.
DIERR_INSUFFICIENTPRIVS
O usuário atual não tem as permissões necessárias para alterar a configuração do joystick.
DIERR_DEVICECHANGE
Outro aplicativo alterou a configuração global do joystick. A interface precisa ser reinicializada.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dinputd.h (include Dinputd.h)