IDirectInputJoyConfig8::GetUserValues method (dinputd.h)

Article
02/22/2024

The IDirectInputJoyConfig8::GetUserValues method obtains information about user settings for the joystick.

Syntax

HRESULT GetUserValues(
  LPDIJOYUSERVALUES unnamedParam1,
  DWORD             unnamedParam2
);

Parameters

unnamedParam1

Points to a structure that receives information about the user joystick configuration. The caller must initialize the dwSize member of the DIJOYUSERVALUES structure before calling this method.

unnamedParam2

Specifies which members of the DIJOYUSERVALUES structure contain values to be retrieved. There may be zero, one, or more of the following:

DIJU_USERVALUES

Indicates that the user configuration settings (the ruv member of the DIJOYUSERVALUES structure) is being requested.

DIJU_GLOBALDRIVER

Indicates that the global port driver (the wszGlobalDriver member of the DIJOYUSERVALUES structure) is being requested.

A list of valid global drivers can be obtained by enumerating the list of joystick types. If the joystick type has the JOY_HWS_ISGAMEPORTDRIVER flag set in the dwFlags member of the JOYHWSETTINGS structure, then the wszCallout member of the DIJOYTYPEINFO structure contains the name of a driver that can be used as a global driver.

DIJU_GAMEPORTEMULATOR

Unused

Return value

Returns DI_OK if successful; otherwise, returns the following COM error value:

Return code	Description
DIERR_INVALIDPARAM	One or more parameters was invalid.

Requirements

Requirement	Value
Target Platform	Desktop
Header	dinputd.h (include Dinputd.h)

Share via