Skip to main content

Windows Dev Center

SetInertiaParameterInteractionContext function

Configures the inertia behavior of a manipulation (translation, rotation, scaling) after the contact is lifted.

Syntax


HRESULT WINAPI SetInertiaParameterInteractionContext(
  _In_ HINTERACTIONCONTEXT interactionContext,
  _In_ INERTIA_PARAMETER   inertiaParameter,
  _In_ float               value
);

Parameters

interactionContext [in]

The handle of the interaction context.

inertiaParameter [in]

One of the constants from INERTIA_PARAMETER.

value [in]

One of the following:

  • The rate of deceleration, in radians/ms².
  • For translation, the relative change in screen location, in HIMETRIC units.
  • For rotation, the relative change in angle of rotation, in radianx
  • For scaling, the relative change in size, in HIMETRIC units.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Interaction Context uses the inertia system setting for all manipulations (translation, rotation, scaling). This function overrides the system setting.

To restore the system setting, set value to INERTIA_PARAMETER_INVALID_VALUE FLT_MAX.

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

None supported

Header

Interactioncontext.h

Library

Ninput.lib

DLL

Ninput.dll

See also

Interaction Context Functions
HINTERACTIONCONTEXT
GetInertiaParameterInteractionContext