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

Article
04/03/2024

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