Fungsi GetPreferredPacketDescription (recapis.h)

Mengambil deskripsi paket yang berisi properti paket yang digunakan pengenal.

Sintaks

HRESULT GetPreferredPacketDescription(
  HRECOGNIZER        hrec,
  PACKET_DESCRIPTION *pPacketDescription
);

Parameter

hrec

Tangani ke pengenal.

pPacketDescription

Menjelaskan konten paket yang digunakan pengenal. Untuk informasi selengkapnya, lihat struktur PACKET_DESCRIPTION .

Untuk mengambil deskripsi paket, inisialisasi deskripsi paket dengan nol dan panggil fungsi GetPreferredPacketDescription . Fungsi ini mengisi jumlah properti dan tombol, yang Anda gunakan untuk mengalokasikan ruang untuk anggota pPacketProperties dan pguidButtons dari struktur PACKET_DESCRIPTION . Panggil fungsi lagi untuk mengisi deskripsi paket lainnya.

Anggota pguidButtons dari struktur PACKET_DESCRIPTION mungkin nol ketika GetPreferredPacketDescription kembali. Ini berarti paket tidak memiliki data tombol, sehingga anggota ini tidak memiliki pguidButton yang dialokasikan. Dalam hal ini, fungsi panggilan harus meninggalkan pointer NULL.

Nilai kembali

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Parameter adalah penunjuk yang tidak valid.
TPC_E_INSUFFICIENT_BUFFER	Buffer pPacketDescription terlalu kecil.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.
E_INVALIDARG	Argumen yang tidak valid diterima.

Keterangan

Biasanya, pengenal menggunakan properti koordinat (x, y) dan mengabaikan yang lain. Jika Anda menyimpan tinta ke file untuk pengenalan di lain waktu, gunakan deskripsi paket pilihan untuk hanya menyimpan properti yang digunakan pengenal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	recapis.h
DLL	inkobjcore.dll

Lihat juga

Fungsi AddStroke

Struktur PACKET_DESCRIPTION