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 値を返します。
解説
認識するテキストの種類は、アプリケーションで使用されるサービスの種類によって異なります。 詳細については、「 テキスト認識の要求」を参照してください。
MappingFreePropertyBag。 これは、同期呼び出しと非同期呼び出しの両方が に対して行われるためです。
MappingRecognizeText と MappingDoAction は、初期に渡されたデータの使用を試みます
MappingRecognizeText を呼び出します。
要件
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | elscore.h |
| Library | Elscore.lib |
| [DLL] | Elscore.dll |