Funzione GetPreferredPacketDescription (recapis.h)
Recupera una descrizione del pacchetto che contiene le proprietà del pacchetto usate dal riconoscimento.
Sintassi
HRESULT GetPreferredPacketDescription(
HRECOGNIZER hrec,
PACKET_DESCRIPTION *pPacketDescription
);
Parametri
hrec
Gestire il riconoscimento.
pPacketDescription
Descrive il contenuto dei pacchetti usati dal riconoscimento. Per altre informazioni, vedere la struttura PACKET_DESCRIPTION .
Per recuperare la descrizione del pacchetto, inizializzare la descrizione del pacchetto con zero e chiamare la funzione GetPreferredPacketDescription . La funzione popola i conteggi delle proprietà e dei pulsanti, usati per allocare spazio per i membri pPacketProperties e pguidButtons della struttura PACKET_DESCRIPTION . Chiamare di nuovo la funzione per popolare il resto della descrizione del pacchetto.
Il membro pguidButtons della struttura PACKET_DESCRIPTION può essere zero quando GetPreferredPacketDescription restituisce . Ciò significa che i pacchetti non dispongono di dati del pulsante, quindi questo membro non dispone di alcun pguidButton allocato. In questo caso, la funzione chiamante deve lasciare il puntatore NULL.
Valore restituito
Questa funzione può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. |
|
Il parametro è un puntatore non valido. |
|
Il buffer pPacketDescription è troppo piccolo. |
|
Si è verificato un errore non specificato. |
|
È stato ricevuto un argomento non valido. |
Commenti
In genere, i riconoscimento usano le proprietà delle coordinate (x, y) e ignorano gli altri. Se si salva l'input penna in un file per il riconoscimento in un secondo momento, utilizzare la descrizione del pacchetto preferito per salvare solo le proprietà usate dal riconoscimento.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP Tablet PC Edition [solo app desktop] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | recapis.h |
| DLL | inkobjcore.dll |