MappingRecognizeText 함수(elscore.h)

아티클
08/23/2023

ELS 서비스를 호출하여 텍스트를 인식합니다. 예를 들어 Microsoft 언어 감지 서비스는 입력 텍스트가 작성된 언어를 인식하려고 시도합니다.

구문

HRESULT MappingRecognizeText(
  [in]           PMAPPING_SERVICE_INFO pServiceInfo,
  [in]           LPCWSTR               pszText,
  [in]           DWORD                 dwLength,
  [in]           DWORD                 dwIndex,
  [in, optional] PMAPPING_OPTIONS      pOptions,
  [in, out]      PMAPPING_PROPERTY_BAG pbag
);

매개 변수

[in] pServiceInfo

텍스트 인식에 사용할 서비스에 대한 정보를 포함하는 MAPPING_SERVICE_INFO 구조체에 대한 포인터입니다. 구조체는 MappingGetServices에 대한 이전 호출에 의해 검색된 구조체 중 하나여야 합니다. 이 매개 변수는 NULL로 설정할 수 없습니다.

[in] pszText

인식할 텍스트에 대한 포인터입니다. 텍스트는 UTF-16이어야 하지만 일부 서비스에는 입력 형식에 대한 추가 요구 사항이 있습니다. 이 매개 변수는 NULL로 설정할 수 없습니다.

[in] dwLength

pszText에 지정된 텍스트의 길이(문자)입니다.

[in] dwIndex

서비스에서 사용할 지정된 텍스트 내의 인덱스입니다. 이 값은 0에서 dwLength-1 사이여야 합니다. 애플리케이션에서 전체 텍스트를 처리하려는 경우 이 매개 변수를 0으로 설정해야 합니다.

[in, optional] pOptions

텍스트 인식의 결과와 동작에 영향을 주는 옵션을 포함하는 MAPPING_OPTIONS 구조체에 대한 포인터입니다. 애플리케이션은 모든 구조체 멤버에 대한 값을 지정할 필요가 없습니다. 기본 매핑 옵션을 사용하려면 이 매개 변수를 NULL 로 설정할 수 있습니다.

[in, out] pbag

서비스에서 결과를 저장하는 MAPPING_PROPERTY_BAG 구조체에 대한 포인터입니다. 입력 시 애플리케이션은 제공된 크기만 있는 구조체를 전달하고 다른 멤버는 0으로 설정합니다. 출력 시 구조체는 텍스트 인식 중에 서비스에서 생성된 정보로 채워집니다. 이 매개 변수는 NULL로 설정할 수 없습니다.

반환 값

성공하면 S_OK 반환합니다. 함수는 성공하지 못하면 오류 HRESULT 값을 반환합니다.

설명

인식할 텍스트의 형식은 애플리케이션에서 사용하는 서비스 유형에 따라 달라집니다. 자세한 내용은 텍스트 인식 요청을 참조하세요.

경고pszText 및 pOptions 에서 참조하는 데이터는 pBag 에서 전달된 속성 모음 구조를 통해 해제될 때까지 유효한 상태를 유지해야 합니다.

MappingFreePropertyBag. 동기 및 비동기 모두 에 대한 호출이기 때문입니다.

MappingRecognizeText 및 MappingDoAction 은 초기 에 전달된 데이터를 사용하려고 시도합니다.

MappingRecognizeText를 호출합니다.

요구 사항


지원되는 최소 클라이언트	Windows 7 [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	elscore.h
라이브러리	Elscore.lib
DLL	Elscore.dll