Partager via


GetUnicodeRanges, fonction (recapis.h)

Retourne les plages de points Unicode que le module de reconnaissance prend en charge.

Syntaxe

HRESULT GetUnicodeRanges(
  HRECOGNIZER     hrec,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

Paramètres

hrec

Handle vers le module de reconnaissance.

pcRanges

Lors de l’entrée, le nombre de plages que la mémoire tampon pcr peut contenir. Sur la sortie, le nombre de plages que contient la mémoire tampon pcr .

pcr

Tableau de structures CHARACTER_RANGE . Chaque structure contient une plage de points Unicode pris en charge par le module de reconnaissance. L’ordre du tableau est arbitraire. Pour déterminer la taille requise de la mémoire tampon, définissez pcr sur NULL ; utiliser le nombre de plages pour allouer la mémoire tampon pcr .

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
Réussite.
E_POINTER
L’un des paramètres est un pointeur non valide.
TPC_E_INSUFFICIENT_BUFFER
La mémoire tampon pcr est trop petite.
E_FAIL
Une erreur non spécifiée s'est produite.
E_INVALIDARG
Un argument non valide a été reçu.
E_OUTOFMEMORY
Mémoire insuffisante.

Remarques

Cette fonction est facultative.

Certains modules de reconnaissance ne prennent pas en charge cette fonctionnalité, mais peuvent toujours inclure la fonction GetUnicodeRanges Function . Pour ces modules de reconnaissance, la fonction GetUnicodeRanges retourne E_NOTIMPL.

Pour contrôler les plages Unicode utilisées par un contexte de reconnaissance spécifique, utilisez les fonctions GetEnabledUnicodeRanges et SetEnabledUnicodeRanges . Ces plages sont contraintes d’être un sous-ensemble des plages retournées par GetUnicodeRanges.

Les modules de reconnaissance de mouvements Microsoft utilisent des caractères Unicode de 0xF000 à 0xF0FF. Chaque valeur Unicode unique dans cette plage représente un seul mouvement. Pour obtenir la liste complète des valeurs Unicode pour les mouvements, consultez Valeurs de plage Unicode des mouvements.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP Édition Tablet PC [applications de bureau | Applications UWP]
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête recapis.h
DLL inkobjcore.dll

Voir aussi

GetEnabledUnicodeRanges, fonction

SetEnabledUnicodeRanges, fonction