Metodo IRealTimeStylus::SetDesiredPacketDescription (rtscom.h)

Articolo
08/25/2023

Richiede l'inserimento delle proprietà nel flusso di pacchetti.

Sintassi

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

Parametri

[in] cProperties

Conteggio delle proprietà specificate dal parametro pPropertyGuids . I valori validi sono compresi tra 0 e 32, inclusi.

[in] pPropertyGuids

Matrice di identificatori univoci globali (GUID) per le proprietà richieste per essere incluse nel flusso di pacchetti.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Gli eventi ricevono le proprietà dei pacchetti effettivi nell'ordine seguente.

Ordine dei pacchetti	Descrizione
Posizione 1°	Contiene i dati di coordinata x per la proprietà indipendentemente dal fatto che X sia stato specificato nella proprietà DesiredPacketDescription.
Posizione 2°	Contiene i dati di coordinata y per la proprietà indipendentemente dal fatto che Y sia stato specificato nella proprietà DesiredPacketDescription.
Posizione finale	Contiene lo stato del pacchetto quando lo stato del pacchetto si trova nella proprietà DesiredPacketDescription.

Nota Il risultato del metodo IRealTimeStylus::GetPacketDescriptionData potrebbe non corrispondere alle proprietà del metodo IRealTimeStylus::SetDesiredPacketDescription come alcune delle proprietà potrebbero non essere supportate dal tablet.

Se le proprietà dei pacchetti specificate non sono supportate dai dispositivi tablet, i dati delle proprietà non vengono restituiti e non sono rappresentati nella matrice di dati dei pacchetti. Se lo stesso GUID viene visualizzato più volte nell'argomento packetDescription , viene mantenuto solo il primo aspetto e vengono filtrate tutte le apparizioni seguenti. Il metodo IRealTimeStylus::SetDesiredPacketDescription può essere chiamato solo mentre l'oggetto Classe RealTimeStylus è disabilitato.

Il tentativo di passare 0 per cProperties e NULL per pPropertyGuids restituisce E_INVALIDARG.

Le chiamate al metodo IRealTimeStylus::SetDesiredPacketDescription vengono immediatamente riflesse nel valore restituito del metodo IRealTimeStylus::GetDesiredPacketDescription.

Esempio

Il codice di esempio C++ seguente imposta le proprietà richieste per essere incluse nel flusso di pacchetti.

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]);
    }
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	rtscom.h
DLL	RTSCom.dll

Vedi anche

IRealTimeStylus

Metodo IRealTimeStylus::GetDesiredPacketDescription

Metodo IRealTimeStylus::GetPacketDescriptionData

Classe RealTimeStylus

Condividi tramite