ProcessPointerFramesInteractionContext function (interactioncontext.h)

Processes a set of pointer input frames.

Syntax

HRESULT ProcessPointerFramesInteractionContext(
  [in] HINTERACTIONCONTEXT interactionContext,
  [in] UINT32              entriesCount,
  [in] UINT32              pointerCount,
  [in] const POINTER_INFO  *pointerInfo
);

Parameters

[in] interactionContext

Pointer to a handle for the Interaction Context.

[in] entriesCount

Number of frames to process.

[in] pointerCount

Number of pointers in each frame.

[in] pointerInfo

Pointer to the array of frames (of size entriesCount).

Return value

If this function succeeds, it returns S_OK.

Otherwise, it returns an HRESULT error code.

Remarks

Output notifications are sent as required.

Frames must be processed in reverse chronological order (most recent data first).

Each frame must have the same set of input pointers.

Each pointer must originate from a different contact.

If pointer filtering is set, a sub-frame that includes the specified pointers is extracted from each frame. Pointers are specified through the AddPointerInteractionContext function and pointer filtering turned on by setting INTERACTION_CONTEXT_PROPERTY_FILTER_POINTERS in the SetPropertyInteractionContext function.

Requirements