IInkRecognizerContext::Recognize メソッド (msinkaut.h)

InkStrokes コレクションに対して認識を実行し、認識結果を返します。

構文

HRESULT Recognize(
  [in, out]     InkRecognitionStatus  *RecognitionStatus,
  [out, retval] IInkRecognitionResult **RecognitionResult
);

パラメーター

[in, out] RecognitionStatus

最新の InkRecognitionStatus 値。

[out, retval] RecognitionResult

このメソッドから制御が戻るときに、認識されたストロークのコレクションの IInkRecognitionResult 結果へのポインターが格納されます。認識エンジンがインクの結果を計算できなかった場合は NULL を 返します。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード	説明
S_OK	正常終了しました。
E_POINTER	パラメーターに無効なポインターが含まれていました。
E_UNEXPECTED	予期しないパラメーターまたはプロパティの型。
E_INK_EXCEPTION	メソッド内で例外が発生しました。
E_OUTOFMEMORY	メモリ操作を割り当てることができません。

注釈

このメソッドは、認識を同期的に実行します。 バックグラウンド認識または非同期認識を開始するには、 BackgroundRecognize メソッドまたは BackgroundRecognizeWithAlternates メソッドを 呼び出します。

InkDisp オブジェクトにストロークまたは削除されたストロークのみが含まれている場合に例外がスローされるため、Recognize を呼び出すときは try/catch ブロックを使用する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows XP タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	msinkaut.h
Library	InkObj.dll

こちらもご覧ください

BackgroundRecognize メソッド

BackgroundRecognizeWithAlternates メソッド

IInkRecognitionResult インターフェイス

IInkRecognizerContext

InkDisp クラス

InkRecognizerContext クラス

InkStrokes コレクション