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

IInkRecognizer オブジェクトが関連付けられているストロークコレクションを認識し、認識が完了したときに Recognition イベントを発生させます。

構文

HRESULT BackgroundRecognize(
  [in, optional] VARIANT CustomData
);

[in, optional] CustomData

Recognition イベントでアプリケーションで使用できるアプリケーション定義データを指定します。このパラメーターは、データを渡す必要がない場合は、VT_EMPTY型またはVT_NULL型の VARIANT である場合があります。既定値は NULL です。

VARIANT 構造体の詳細については、「 COM ライブラリの使用」を参照してください。

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

リターンコード	説明
S_OK	正常終了しました。
E_OUTOFMEMORY	操作を完了するためにメモリを割り当てることができません。
E_INK_NO_STROKES_TO_RECOGNIZE	ストロークは存在しません。
E_INK_EXCEPTION	メソッド内で例外が発生しました。

このメソッドは、インク認識を非同期的に実行することを指定します。インクを同期的に認識するには、 Recognize メソッドを呼び出します。

このメソッドは、最適な結果文字列のみを認識します。代替は作成されません。使用可能な代替候補の一覧を作成する認識を実行するには、 BackgroundRecognizeWithAlternates メソッドを呼び出します。

認識エンジンが何も認識しない場合、 Recognition イベントは発生しません。

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