MappingRecognizeText 関数 (elscore.h)

テキストを認識するために 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。 これは、同期呼び出しと非同期呼び出しの両方が に対して行われるためです。

MappingRecognizeTextMappingDoAction は、初期に渡されたデータの使用を試みます

MappingRecognizeText を呼び出します。

 

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー elscore.h
Library Elscore.lib
[DLL] Elscore.dll

関連項目

拡張言語サービス

拡張言語サービス関数

MAPPING_OPTIONS

MAPPING_PROPERTY_BAG

MAPPING_SERVICE_INFO

テキスト認識の要求