IRealTimeStylus：：SetDesiredPacketDescription 方法 (rtscom.h)

要求要包含在封包數據流中的屬性。

語法

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

參數

[in] cProperties

pPropertyGuids 參數所指定的屬性計數。 有效值介於 0 到 32 之間，包含。

[in] pPropertyGuids

全域唯一標識碼的陣列 (GUID，) 要求包含在封包數據流中的屬性。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

事件會依下列順序接收實際的封包屬性。

封包順序	Description
第1個位置	包含屬性的 X 座標數據，不論 是否在 DesiredPacketDescription 屬性中指定 X。
第2個位置	包含屬性的 Y 座標數據，不論 Y 是否在 DesiredPacketDescription 屬性中指定。
結束位置	當封包狀態在 DesiredPacketDescription 屬性中時，會包含封包狀態。

 

注意IRealTimeStylus：：GetPacketDescriptionData 方法的結果可能不符合 IRealTimeStylus：：SetDesiredPacketDescription 方法屬性，因為平板計算機可能不支援某些屬性。

 

如果平板電腦裝置不支援指定的封包屬性，則不會傳回屬性數據，而且不會在封包數據數位中表示。 如果packetDescription自變數中出現相同的 GUID 多次，則只會保留第一個外觀，並篩選出下列所有外觀。只有在停用 RealTimeStylus Class 物件時，才能呼叫 IRealTimeStylus：：SetDesiredPacketDescription 方法方法。

嘗試針對 cProperties 傳入 0，pPropertyGuids 的 NULL 會傳回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
標頭	rtscom.h
Dll	RTSCom.dll

另請參閱

IRealTimeStylus

IRealTimeStylus：：GetDesiredPacketDescription 方法

IRealTimeStylus：：GetPacketDescriptionData 方法

RealTimeStylus 類別