CallDivideResults function

Article
01/07/2021

Retrieves analysis results from the InkDivider object.

This function is not intended to be used by application code.

Syntax

HRESULT WINAPI CallDivideResults(
  _In_  INT_PTR   hDivider,
  _Out_ int       aWordStrokeIds[],
  _Out_ int       aLineStrokeIds[],
  _Out_ int       aParagraphStrokeIds[],
  _Out_ int       aDrawingStrokeIds[],
  _Out_ SAFEARRAY **pastrWords,
  _Out_ SAFEARRAY **pastrLines,
  _Out_ SAFEARRAY **pastrParagraphs,
  _Out_ int       *aWordRotationCenterX,
  _Out_ int       *aWordRotationCenterY,
  _Out_ float     *aWordAngle,
  _Out_ int       *aLineRotationCenterX,
  _Out_ int       *aLineRotationCenterY,
  _Out_ float     *aLineAngle
);

Parameters

hDivider [in]: A handle to the InkDivider object.
aWordStrokeIds [out]: An array of identifiers associated with the word that is passed in to the InkDivider class.
aLineStrokeIds [out]: An array of ID properties for the IInkStrokeDisp objects associated with the line that is passed in to the InkDivider class.
aParagraphStrokeIds [out]: An array of the ID properties for the IInkStrokeDisp objects associated with the paragraph from the InkDivider class.
aDrawingStrokeIds [out]: An array of ID properties for the IInkStrokeDisp objects associated with the drawing from the InkDivider class.
pastrWords [out]: An array of words returned from ink analysis.
pastrLines [out]: An array of lines returned from ink analysis.
pastrParagraphs [out]: An array of paragraphs returned from ink analysis.
aWordRotationCenterX [out]: An array of the center points of the words along the x-axis from ink analysis.
aWordRotationCenterY [out]: An array of the center points of the words along the y-axis from ink analysis.
aWordAngle [out]: An array containing the angles by which to rotate the words for best analysis results.
aLineRotationCenterX [out]: An array containing the center points of the lines along the x-axis.
aLineRotationCenterY [out]: An array containing the center points of the lines along the y-axis.
aLineAngle [out]: An array containing the angles by which to rotate the lines for best analysis results.

Return value

This function can return one of these values.

Return code	Description
S_OK	The function succeeded.
E_INVALIDARG	The hDivider parameter is invalid.
E_OUTOFMEMORY	Could not allocate enough memory to store the results.

Remarks

To avoid memory leaks you must release the resources for pastrWords, pastrLines, and pastrParagraphs.

Requirements

Requirement	Value
Minimum supported client	Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server	None supported
Library	InkDiv.dll

Share via