IInkAnalyzer::UpdateStrokesData method

Article
01/07/2021

Updates the packet data for the specified strokes.

Syntax

HRESULT UpdateStrokesData(
  [in] ULONG ulStrokeIdsCount,
  [in] LONG  *plStrokeIds,
  [in] ULONG ulStrokePacketDescriptionCount,
  [in] GUID  *pStrokePacketDescriptionGuids,
  [in] ULONG *pulPacketDataCountPerStroke,
  [in] LONG  *plStrokePacketData
);

Parameters

ulStrokeIdsCount [in]: The number of strokes to update.
plStrokeIds [in]: An array containing the stroke identifiers.
ulStrokePacketDescriptionCount [in]: The number of properties in each packet.
pStrokePacketDescriptionGuids [in]: An array containing the packet property identifiers.
pulPacketDataCountPerStroke [in]: An array containing the number of packets in each stroke.
plStrokePacketData [in]: An array containing the packet data for the strokes.

Return value

For a description of the return values, see Classes and Interfaces - Ink Analysis.

Remarks

the plStrokePacketData parameter contains packet data for all of the strokes. The pStrokePacketDescriptionGuids parameter contains the globally unique identifiers (GUIDs) that describe the types of packet data included for each point in each stroke. For a complete list of available packet properties, see PacketPropertyGuids Constants.

Only strokes with the same packet descriptions can be updated in a single call to IInkAnalyzer::UpdateStrokesData Method.

This method does not update the ink analyzer's dirty region (see IInkAnalyzer::GetDirtyRegion Method).

If a specified stroke is not associated with the IInkAnalyzer, this method ignores the identifier.

If none of the specified strokes identify a stroke associated with the IInkAnalyzer, this method returns without updating the IInkAnalyzer.

This method returns an error code when plStrokeIds is NULL.

Requirements

Requirement	Value
Minimum supported client	Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server	None supported
Header	IACom.h (also requires IACom_i.c)
DLL	IACom.dll

Share via