Función GetPreferredPacketDescription (recapis.h)

Recupera una descripción de paquete que contiene las propiedades de paquete que usa el reconocedor.

Sintaxis

HRESULT GetPreferredPacketDescription(
  HRECOGNIZER        hrec,
  PACKET_DESCRIPTION *pPacketDescription
);

Parámetros

hrec

Identificador del reconocedor.

pPacketDescription

Describe el contenido de los paquetes que usa el reconocedor. Para obtener más información, consulte la estructura PACKET_DESCRIPTION .

Para recuperar la descripción del paquete, inicialice la descripción del paquete con ceros y llame a la función GetPreferredPacketDescription . La función rellena los recuentos de propiedades y botones, que se usan para asignar espacio a los miembros pPacketProperties y pguidButtons de la estructura PACKET_DESCRIPTION . Vuelva a llamar a la función para rellenar el resto de la descripción del paquete.

El miembro pguidButtons de la estructura PACKET_DESCRIPTION puede ser cero cuando Se devuelve GetPreferredPacketDescription . Esto significa que los paquetes no tienen datos de botón, por lo que este miembro no tiene asignados pguidButtons. En este caso, la función que llama debe dejar el puntero NULL.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	Correcto.
E_POINTER	El parámetro es un puntero no válido.
TPC_E_INSUFFICIENT_BUFFER	El búfer pPacketDescription es demasiado pequeño.
E_FAIL	Se ha producido un error no especificado.
E_INVALIDARG	Se recibió un argumento no válido.

Comentarios

Normalmente, los reconocedores usan las propiedades de coordenadas (x, y) y omiten las demás. Si guarda la entrada de lápiz en un archivo para el reconocimiento más adelante, use la descripción de paquete preferida para guardar solo las propiedades que usa el reconocedor.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	recapis.h
Archivo DLL	inkobjcore.dll

Consulte también

Función AddStroke

estructura de PACKET_DESCRIPTION