Метод IRealTimeStylus::SetDesiredPacketDescription (rtscom.h)

Статья
08/25/2023

Запрашивает свойства для включения в поток пакетов.

Синтаксис

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

Параметры

[in] cProperties

Количество свойств, заданных параметром pPropertyGuids . Допустимые значения находятся в диапазоне от 0 до 32 включительно.

[in] pPropertyGuids

Массив глобальных уникальных идентификаторов (GUID) для свойств, запрашиваемых для включения в поток пакетов.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Порядок пакетов	Описание
1-я позиция	Содержит данные координат x для свойства независимо от того, был ли указан X в свойстве DesiredPacketDescription.
2-е место	Содержит данные координат Y для свойства независимо от того, был ли указан Y в свойстве DesiredPacketDescription.
Позиция конца	Содержит состояние пакета, если состояние пакета находится в свойстве DesiredPacketDescription.

Примечание Результат метода IRealTimeStylus::GetPacketDescriptionData может не соответствовать свойствам метода IRealTimeStylus::SetDesiredPacketDescription, так как некоторые свойства могут не поддерживаться планшетом.

Если указанные свойства пакета не поддерживаются планшетными устройствами, данные свойства не возвращаются и не представлены в массиве данных пакета. Если один и тот же GUID отображается в аргументе packetDescription несколько раз, сохраняется только первое появление, а все следующие представления отфильтровываются. Метод IRealTimeStylus::SetDesiredPacketDescription можно вызывать только в том случае, если объект Класса RealTimeStylus отключен.

Попытка передать 0 для cProperties и NULL для pPropertyGuids возвращает E_INVALIDARG.

Вызовы метода IRealTimeStylus::SetDesiredPacketDescription немедленно отражаются в возвращаемом значении метода IRealTimeStylus::GetDesiredPacketDescription .

Примеры

В следующем примере кода C++ задаются свойства, которые запрашиваются для включения в поток пакетов.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	rtscom.h
DLL	RTSCom.dll

См. также раздел

IRealTimeStylus

Метод IRealTimeStylus::GetDesiredPacketDescription

Метод IRealTimeStylus::GetPacketDescriptionData

Класс RealTimeStylus

Поделиться через