Share via

AdviseInkChange 함수(recapis.h)

  • 아티클

스트로크가 추가되거나 삭제되었으므로 인식기가 잉크 처리를 중지합니다.

구문

HRESULT AdviseInkChange(
  HRECOCONTEXT hrc,
  BOOL         bNewStroke
);

매개 변수

hrc

인식기 컨텍스트에 대한 핸들입니다.

bNewStroke

새 스트로크를 추가하는 경우 TRUE입니다. Ink 개체에서 스트로크를 지우거나, 분할하거나, 병합하거나, 추출하거나, 삭제한 경우 FALSE 로 설정합니다.

반환 값

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
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 태블릿 PC 버전 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 Windows
헤더 recapis.h
DLL inkobjcore.dll