次の方法で共有

AdviseInkChange 関数 (recapis.h)

  • [アーティクル]

ストロークが追加または削除されたため、認識エンジンがインクの処理を停止します。

構文

HRESULT AdviseInkChange(
  HRECOCONTEXT hrc,
  BOOL         bNewStroke
);

パラメーター

hrc

認識エンジン コンテキストへのハンドル。

bNewStroke

新 しいストロークを追加する場合は TRUE。 インク オブジェクトからストロークが消去、分割、結合、抽出、または削除された場合は FALSE に設定します。

戻り値

この関数は、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 正常終了しました。 認識エンジンがこの関数をサポートしていない場合、この関数はS_OKも返します。
E_POINTER
 パラメーターの 1 つが無効なポインターです。
E_FAIL
 未指定のエラーが発生しました。
E_INVALIDARG
 無効な引数が受け取られました。

注釈

AdviseInkChange 関数は、AddStroke 関数の追加の呼び出しがあることを通知します。 これにより、既に進行中の認識を任意の便利な時点で停止できます。 認識の完了はそのような点の 1 つであるため、 AdviseInkChange は安全に何も実行できません。

たとえば、2 つのスレッドがある場合、1 つのスレッドで AddStroke と Process を他の関数と共に使用して結果を取得できます。 もう 1 つのスレッドは、インクを収集し、それをエコーし、最初のスレッドのタスクをキューに入れ込む可能性があります。 2 番目のスレッドは 、AdviseInkChange を 呼び出して、変更が行われる認識エンジンに通知します。 これにより、最初のスレッドは 、AdviseInkChange の呼び出しがないよりも早く呼び出し元に戻ります。 その後、最初のスレッドは、より多くのインクを使用して認識エンジンを再度呼び出すことができます。

ストロークが変更または削除されたために bNewStroke パラメーターを FALSE に設定した場合は、 ResetContext 関数も呼び出し、 AddStroke 関数を呼び出して InkDisp オブジェクトから認識エンジン コンテキストにストロークを追加する必要があります。 これは、認識エンジン コンテキストを InkDisp オブジェクトにアタッチすると自動的に行われます。

要件

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