AdviseInkChange 函数 (recapis.h)

停止识别器处理墨迹，因为已添加或删除笔划。

语法

HRESULT AdviseInkChange(
  HRECOCONTEXT hrc,
  BOOL         bNewStroke
);

参数

hrc

识别器上下文的句柄。

bNewStroke

如果添加新笔划，则为 TRUE。 如果笔划已从 Ink 对象中擦除、拆分、合并、提取或删除，则设置为 FALSE 。

返回值

此函数可以返回其中一个值。

返回代码	说明
S_OK	成功。 如果识别器不支持此函数，此函数也会返回S_OK。
E_POINTER	其中一个参数是无效的指针。
E_FAIL	发生了未指定的错误。
E_INVALIDARG	收到无效参数。

注解

AdviseInkChange 函数指示将对 AddStroke 函数进行其他调用。 这样，任何已在进行中的识别都能够在任何方便的点停止。 识别完成就是这样一点，因此 AdviseInkChange 可以安全地无所事事。

例如，如果有两个线程，则一个线程可能会将 AddStroke 和 Process 与其他函数一起使用以获取结果。 另一个线程可能正在收集墨迹、回显墨迹，并为第一个线程排队任务。 第二个线程调用 AdviseInkChange 来通知识别器即将发生更改。 这使得第一个线程比不调用 AdviseInkChange 更早地返回调用方。 然后，第一个线程可以使用更多墨迹再次调用识别器。

如果由于修改或删除了笔划而将 bNewStroke 参数设置为 FALSE ，则还必须调用 ResetContext 函数，然后调用 AddStroke 函数以将 InkDisp 对象的笔划添加到识别器上下文。 如果将识别器上下文附加到 InkDisp 对象，则会自动执行此操作。

要求

要求	值
最低受支持的客户端	Windows XP Tablet PC Edition [桌面应用 |UWP 应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	recapis.h
DLL	inkobjcore.dll