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

Artigo
03/05/2024

O método IDirectInputJoyConfig8::SetUserValues define as configurações do usuário para o joystick.

Sintaxe

HRESULT SetUserValues(
  LPCDIJOYUSERVALUES unnamedParam1,
  DWORD              unnamedParam2
);

Parâmetros

unnamedParam1

Aponta para uma estrutura que recebe informações sobre as novas configurações de joystick do usuário.

unnamedParam2

Especifica as partes da estrutura DIJOYUSERVALUES que contêm valores a serem definidos. Pode haver zero, um ou mais dos seguintes:

DIJU_USERVALUES

Indica que as configurações do usuário (o membro ruv da estrutura DIJOYUSERVALUES) são válidas.

DIJU_GLOBALDRIVER

Indica que o driver de porta global (o membro wszGlobalDriver da estrutura DIJOYUSERVALUES) é válido.

Uma lista de drivers globais válidos pode ser obtida enumerando a lista de tipos de joystick. Se o tipo de joystick tiver o sinalizador JOY_HWS_ISGAMEPORTDRIVER definido no membro dwFlags da estrutura JOYHWSETTINGS, o membro wszCallout da estrutura DIJOYTYPEINFO conterá o nome de um driver que pode ser usado como um driver global.

DIJU_GAMEPORTEMULATOR

Não utilizado.

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_NOTACQUIRED	A configuração do Joystick não foi adquirida. Você deve chamar IDirectInputJoyConfig8::Acquire antes de notificar aplicativos e drivers de alterações na configuração do joystick.
DIERR_INVALIDPARAM	Um ou mais parâmetros eram inválidos.

Requisitos

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