IDirectInputJoyConfig8::SetConfig method (dinputd.h)

Article
02/22/2024

The IDirectInputJoyConfig8::SetConfig method creates or redefines configuration information about a joystick.

Syntax

HRESULT SetConfig(
  UINT           unnamedParam1,
  LPCDIJOYCONFIG unnamedParam2,
  DWORD          unnamedParam3
);

Parameters

unnamedParam1

Indicates a zero-based joystick identification number.

unnamedParam2

Contains information about the joystick.

unnamedParam3

Specifies the parts of the DIJOYCONFIG structure pointed to by pcfg that contain information to be set. There may be zero, one, or more of the following:

DIJC_REGHWCONFIGTYPE

Indicates that the hardware configuration for the joystick (the hwc member of the DIJOYCONFIG structure) and the joystick type name (the wszType member of the DIJOYCONFIG) are valid. Note that the hardware configuration and type name cannot be set separately.

DIJC_GAIN

Indicates that the force-feedback gain for the joystick is valid.

DIJC_CALLOUT

Indicates that the joystick polling callout is valid.

Return value

Returns DI_OK if successful; otherwise, returns one of the following COM error values:

Return code	Description
DIERR_NOTACQUIRED	Joystick configuration has not been acquired. You must call IDirectInputJoyConfig8::Acquire before you can notify applications and drivers of changes to joystick configuration.
DIERR_INVALIDPARAM	One or more parameters was invalid.

Requirements

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

Share via