IInkAnalyzer::CreateCustomRecognizer method

Creates a new custom recognizer node for the IInkAnalyzer.

Syntax

HRESULT CreateCustomRecognizer(
  [in]  const GUID         *pInkAnalysisRecognizerId,
  [out]       IContextNode **ppContextNode
);

Parameters

pInkAnalysisRecognizerId [in]

The globally unique identifier (GUID) of the IInkAnalysisRecognizer for which to create a node.

ppContextNode [out]

A pointer to the IContextNode object representing the new custom recognizer node.

Return value

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

Remarks

Caution

To avoid a memory leak, call IUnknown::Release on ppContextNode when you no longer need to use the object.

This method creates a new IContextNode with a type of CustomRecognizer (see IContextNode::GetType). It then adds the new custom recognizer node to the subnodes collection of the IInkAnalyzer object's root node (see IContextNode::GetSubNodes and IInkAnalyzer::GetRootNode Method).

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

See also

IInkAnalyzer

IContextNode

IInkAnalysisRecognizer

IInkAnalyzer::GetInkAnalysisRecognizersByPriority Method

Ink Analysis Reference