次の方法で共有

IRealTimeStylus::SetDesiredPacketDescription メソッド (rtscom.h)

  • [アーティクル]

パケット ストリームに含めるプロパティを要求します。

構文

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

パラメーター

[in] cProperties

pPropertyGuids パラメーターで指定されたプロパティの数。 有効な値は、0 ~ 32 の範囲です。

[in] pPropertyGuids

パケット ストリームに含める必要があるプロパティのグローバル一意識別子 (GUID) の配列。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

イベントは、実際のパケット プロパティを次の順序で受け取ります。

パケットの順序 説明
1 番目の位置 DesiredPacketDescription プロパティで X が指定されているかどうかに関係なく、 プロパティの x 座標データを格納します。
2 番目の位置 DesiredPacketDescription プロパティで Y が指定されているかどうかに関係なく、 プロパティの y 座標データを格納します。
終了位置 パケットの状態が DesiredPacketDescription プロパティにある場合のパケットの状態を格納します。
 
メモIRealTimeStylus::GetPacketDescriptionData メソッドの結果が IRealTimeStylus::SetDesiredPacketDescription メソッドのプロパティと一致しない場合があります。これは、一部のプロパティがタブレットでサポートされていない可能性があるためです。
 
指定されたパケット プロパティがタブレット デバイスでサポートされていない場合、プロパティ データは返されず、パケット データ配列では表されません。 packetDescription 引数に同じ GUID が複数回表示される場合、最初の外観のみが保持され、次のすべての外観がフィルター処理されます。IRealTimeStylus::SetDesiredPacketDescription メソッドは、RealTimeStylus クラス オブジェクトが無効になっている間のみ呼び出すことができます。

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 クラス