Metode IRealTimeStylus::SetDesiredPacketDescription (rtscom.h)

Artikel
03/13/2024

Meminta properti untuk disertakan dalam aliran paket.

Sintaks

HRESULT SetDesiredPacketDescription(
  [in] ULONG      cProperties,
  [in] const GUID *pPropertyGuids
);

Parameter

[in] cProperties

Jumlah properti yang ditentukan oleh parameter pPropertyGuids . Nilai yang valid adalah antara 0 dan 32, inklusif.

[in] pPropertyGuids

Array pengidentifikasi unik global (GUID) untuk properti yang diminta untuk disertakan dalam aliran paket.

Nilai kembali

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Peristiwa menerima properti paket aktual dalam urutan berikut.

Urutan paket	Deskripsi
Posisi pertama	Berisi data koordinat x untuk properti terlepas dari apakah X ditentukan dalam Properti DesiredPacketDescription.
Posisi ke-2	Berisi data koordinat y untuk properti terlepas dari apakah Y ditentukan dalam Properti DesiredPacketDescription.
Posisi akhir	Berisi status paket ketika status paket berada di Properti DesiredPacketDescription.

Catatan Hasil dari Metode IRealTimeStylus::GetPacketDescriptionData mungkin tidak cocok dengan properti Metode IRealTimeStylus::SetDesiredPacketDescription karena beberapa properti mungkin tidak didukung oleh tablet.

Jika properti paket yang ditentukan tidak didukung oleh perangkat tablet, data properti tidak dikembalikan dan tidak diwakili dalam array data paket. Jika GUID yang sama muncul beberapa kali dalam argumen packetDescription , hanya tampilan pertama yang dipertahankan dan semua tampilan berikut difilter. Metode Metode IRealTimeStylus::SetDesiredPacketDescription hanya dapat dipanggil saat objek Kelas RealTimeStylus dinonaktifkan.

Mencoba meneruskan 0 untuk cProperties dan NULL untuk pPropertyGuids mengembalikan E_INVALIDARG.

Panggilan ke metode Metode IRealTimeStylus::SetDesiredPacketDescription segera tercermin dalam nilai pengembalian metode Metode IRealTimeStylus::GetDesiredPacketDescription .

Contoh

Kode contoh C++ berikut mengatur properti yang diminta untuk disertakan dalam aliran paket.

GUID guidDesiredPacketDescription[] = { GUID_PACKETPROPERTY_GUID_X, 
                                        GUID_PACKETPROPERTY_GUID_Y, 
                                        GUID_PACKETPROPERTY_GUID_NORMAL_PRESSURE,
                                        GUID_PACKETPROPERTY_GUID_TANGENT_PRESSURE };

// Number of properties in the array
ULONG ulProperties = sizeof(guidDesiredPacketDescription) / sizeof(GUID);

// Set the packet information we'd like to get
if (SUCCEEDED(g_pRealTimeStylus->SetDesiredPacketDescription(ulProperties, guidDesiredPacketDescription)))
{
    TRACE("Set the desired packet description successfully.\n");
}

GUID* pGuids = NULL;

// See if setting the properties was successful
if (SUCCEEDED(g_pRealTimeStylus->GetDesiredPacketDescription(&ulProperties, &pGuids)))
{
    TRACE("The RealTimeStylus supports %d properties.\n", ulProperties);

    // Display the values of the GUIDs in debug output
    for (int i = 0; i < ulProperties; i++)
    {
        TRACE("GUID #%d == %d\n", i, pGuids[i]);
    }
}

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::GetPacketDescriptionData

Kelas RealTimeStylus

Bagikan melalui