AdviseInkChange 함수(recapis.h)
스트로크가 추가되거나 삭제되었으므로 인식기가 잉크 처리를 중지합니다.
구문
HRESULT AdviseInkChange(
HRECOCONTEXT hrc,
BOOL bNewStroke
);
매개 변수
hrc
인식기 컨텍스트에 대한 핸들입니다.
bNewStroke
새 스트로크를 추가하는 경우 TRUE입니다. Ink 개체에서 스트로크를 지우거나, 분할하거나, 병합하거나, 추출하거나, 삭제한 경우 FALSE 로 설정합니다.
반환 값
이 함수는 이러한 값 중 하나를 반환할 수 있습니다.
반환 코드 | Description |
---|---|
|
성공. 또한 이 함수는 인식기가 이 함수를 지원하지 않는 경우 S_OK 반환합니다. |
|
매개 변수 중 하나가 잘못된 포인터입니다. |
|
지정되지 않은 오류가 발생했습니다. |
|
잘못된 인수가 수신되었습니다. |
설명
AdviseInkChange 함수는 AddStroke 함수에 대한 추가 호출이 있을 것임을 신호로 표시합니다. 이렇게 하면 이미 진행 중인 모든 인식이 편리한 지점에서 중지할 수 있습니다. 인식 완성은 이러한 점 중 하나이므로 AdviseInkChange 는 아무 것도 안전하게 수행할 수 없습니다.
예를 들어 두 개의 스레드가 있는 경우 한 스레드가 다른 함수와 함께 AddStroke 및 Process 를 사용하여 결과를 얻을 수 있습니다. 다른 스레드는 잉크를 수집하고, 에코하고, 첫 번째 스레드에 대한 작업을 큐에 대기할 수 있습니다. 두 번째 스레드는 AdviseInkChange 를 호출하여 인식기에게 변경이 오고 있다고 알립니다. 이렇게 하면 첫 번째 스레드가 AdviseInkChange를 호출하지 않고 호출자에게 더 빨리 반환할 수 있습니다. 그런 다음 첫 번째 스레드는 더 많은 잉크로 인식기를 다시 호출할 수 있습니다.
스트로크가 수정되거나 삭제되어 bNewStroke 매개 변수를 FALSE 로 설정한 경우 ResetContext 함수를 호출한 다음 AddStroke 함수를 호출하여 InkDisp 개체의 스트로크를 인식기 컨텍스트에 추가해야 합니다. 이 작업은 InkDisp 개체에 인식기 컨텍스트를 연결하는 경우 자동으로 수행됩니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows XP 태블릿 PC 버전 [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | 지원되는 버전 없음 |
대상 플랫폼 | Windows |
헤더 | recapis.h |
DLL | inkobjcore.dll |