MappingRecognizeText-Funktion (elscore.h)

Artikel
08/23/2023

Ruft einen ELS-Dienst auf, um Text zu erkennen. Der Microsoft-Spracherkennungsdienst versucht beispielsweise, die Sprache zu erkennen, in der der Eingabetext geschrieben wird.

Syntax

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
);

Parameter

[in] pServiceInfo

Zeiger auf eine MAPPING_SERVICE_INFO Struktur, die Informationen zum Dienst enthält, der bei der Texterkennung verwendet werden soll. Die -Struktur muss eine der Strukturen sein, die von einem vorherigen Aufruf von MappingGetServices abgerufen wurden. Dieser Parameter kann nicht auf NULL festgelegt werden.

[in] pszText

Zeiger auf den zu erkennenden Text. Der Text muss UTF-16 sein, aber einige Dienste haben zusätzliche Anforderungen für das Eingabeformat. Dieser Parameter kann nicht auf NULL festgelegt werden.

[in] dwLength

Länge des in pszText angegebenen Texts in Zeichen.

[in] dwIndex

Index innerhalb des angegebenen Texts, der vom Dienst verwendet werden soll. Dieser Wert sollte zwischen 0 und dwLength-1 sein. Wenn die Anwendung den gesamten Text verarbeiten möchte, sollte sie diesen Parameter auf 0 festlegen.

[in, optional] pOptions

Zeiger auf eine MAPPING_OPTIONS-Struktur , die Optionen enthält, die sich auf das Ergebnis und das Verhalten der Texterkennung auswirken. Die Anwendung muss keine Werte für alle Strukturmember angeben. Dieser Parameter kann auf NULL festgelegt werden, um die Standardzuordnungsoptionen zu verwenden.

[in, out] pbag

Zeiger auf eine MAPPING_PROPERTY_BAG-Struktur , in der der Dienst seine Ergebnisse speichert. Bei der Eingabe übergibt die Anwendung eine Struktur mit nur der angegebenen Größe, und die anderen Member sind auf 0 festgelegt. Bei der Ausgabe wird die Struktur mit Informationen gefüllt, die der Dienst während der Texterkennung erzeugt. Dieser Parameter kann nicht auf NULL festgelegt werden.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Die Funktion gibt einen HRESULT-Fehlerwert zurück, wenn sie nicht erfolgreich ist.

Hinweise

Der Typ des zu erkennenden Texts hängt vom Diensttyp ab, der von der Anwendung verwendet wird. Weitere Informationen finden Sie unter Anfordern der Texterkennung.

Warnung Die daten, auf die von pszText und pOptions verwiesen wird, müssen gültig bleiben, bis die von pBag übergebene Eigenschaftenbehälterstruktur über freigegeben wird.

MappingFreePropertyBag. Dies liegt daran, dass sowohl synchrone als auch asynchrone Aufrufe von

MappingRecognizeText und MappingDoAction versuchen, die daten zu verwenden, die an den anfang übergeben wurden.

Aufruf von MappingRecognizeText.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	elscore.h
Bibliothek	Elscore.lib
DLL	Elscore.dll