Partager via


IInkRecognizerContext ::Recognize, méthode (msinkaut.h)

Effectue la reconnaissance sur une collection InkStrokes et retourne les résultats de la reconnaissance.

Syntaxe

HRESULT Recognize(
  [in, out]     InkRecognitionStatus  *RecognitionStatus,
  [out, retval] IInkRecognitionResult **RecognitionResult
);

Paramètres

[in, out] RecognitionStatus

Valeur InkRecognitionStatus la plus récente.

[out, retval] RecognitionResult

Lorsque cette méthode est retournée, contient un pointeur vers les résultats IInkRecognitionResult d’une collection reconnue de traits, ou null si le module de reconnaissance n’a pas pu calculer un résultat pour l’encre.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
Réussite.
E_POINTER
Un paramètre contenait un pointeur non valide.
E_UNEXPECTED
Paramètre ou type de propriété inattendu.
E_INK_EXCEPTION
Une exception s’est produite à l’intérieur de la méthode .
E_OUTOFMEMORY
Impossible d’allouer l’opération de mémoire.

Remarques

Cette méthode effectue la reconnaissance de façon synchrone. Pour démarrer la reconnaissance en arrière-plan ou asynchrone, appelez les méthodes BackgroundRecognize ou BackgroundRecognizeWithAlternates .

Vous devez utiliser un bloc try/catch lors de l’appel de Recognize , car une exception est levée lorsque l’objet InkDisp ne contient aucun trait ou uniquement des traits supprimés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP Édition Tablette PC [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête msinkaut.h
Bibliothèque InkObj.dll

Voir aussi

BackgroundRecognize, méthode

BackgroundRecognizeWithAlternates, méthode

IInkRecognitionResult, interface

IInkRecognizerContext

InkDisp, classe

InkRecognizerContext, classe

InkStrokes Collection