Metode IRealTimeStylus::GetPacketDescriptionData (rtscom.h)

Mengambil properti paket dan faktor penskalakan.

Sintaks

HRESULT GetPacketDescriptionData(
  [in]      TABLET_CONTEXT_ID tcid,
  [in, out] FLOAT             *pfInkToDeviceScaleX,
  [in, out] FLOAT             *pfInkToDeviceScaleY,
  [in, out] ULONG             *pcPacketProperties,
  [out]     PACKET_PROPERTY   **ppPacketProperties
);

Parameter

[in] tcid

Menentukan pengidentifikasi konteks tablet.

[in, out] pfInkToDeviceScaleX

Menentukan faktor konversi untuk sumbu horizontal dari ruang tinta ke koordinat digitizer.

[in, out] pfInkToDeviceScaleY

Menentukan faktor konversi untuk sumbu vertikal dari ruang tinta ke koordinat digitizer.

[in, out] pcPacketProperties

Jumlah properti di setiap paket.

[out] ppPacketProperties

Penunjuk ke array yang berisi GUID dan metrik properti untuk setiap properti paket.

Nilai kembali

Untuk deskripsi nilai yang dikembalikan, lihat Kelas dan Antarmuka RealTimeStylus.

Keterangan

Anda dapat meneruskan NULL jika Anda tidak menginginkan parameter penskalakan.

Metode IRealTimeStylus::GetPacketDescriptionData menggunakan CoTaskMemAlloc untuk mengalokasikan ruang untuk ppPacketProperties. Pemanggil harus memanggil CoTaskMemFree ketika array tidak lagi diperlukan.

Urutan properti dalam aliran data yang dikirim ke plug-in sama dengan urutan properti yang dikembalikan oleh Metode IRealTimeStylus::GetPacketDescriptionData. Gunakan metode ini untuk menentukan apa yang dilaporkan perangkat keras versus apa yang diminta saat memanggil Metode IRealTimeStylus::SetDesiredPacketDescription.

Contoh

Contoh kode C++ ini menggunakan metode Metode IRealTimeStylus::GetPacketDescriptionData untuk mendapatkan informasi tentang data paket tinta.

STDMETHODIMP CCustomRenderer::StylusUp( 
            /* [in] */ IRealTimeStylus *piRtsSrc,
            /* [in] */ const StylusInfo *pStylusInfo,
            /* [in] */ ULONG cPropCountPerPkt,
            /* [size_is][in] */ LONG *pPacket,
            /* [out][in] */ LONG **ppInOutPkt)
{
TABLET_CONTEXT_ID *pTcids;
ULONG ulTcidCount;
TABLET_CONTEXT_ID tcid;
FLOAT fInkToDeviceScaleX;
FLOAT fInkToDeviceScaleY;
ULONG ulPacketProperties;
PACKET_PROPERTY *pPacketProperties;

// Get all the tablet context identifiers
HRESULT hr = piRtsSrc->GetAllTabletContextIds(&ulTcidCount, &pTcids);

// Use the first tablet context identifier in the array
tcid = *pTcids;

// Get the packet description data
hr = piRtsSrc->GetPacketDescriptionData(tcid, &fInkToDeviceScaleX, 
                                        &fInkToDeviceScaleY, &ulPacketProperties,
                                        &pPacketProperties);

// Use the packet description data to do things like scale the ink 
// to the physical display device when rendering your own strokes

	return S_OK;
}

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	rtscom.h
DLL	RTSCom.dll

Lihat juga

IRealTimeStylus

Metode IRealTimeStylus::GetDesiredPacketDescription

Metode IRealTimeStylus::SetDesiredPacketDescription

Kelas RealTimeStylus