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

パケットのプロパティとスケーリング 要因を取得します。

構文

HRESULT GetPacketDescriptionData(
  [in]      TABLET_CONTEXT_ID tcid,
  [in, out] FLOAT             *pfInkToDeviceScaleX,
  [in, out] FLOAT             *pfInkToDeviceScaleY,
  [in, out] ULONG             *pcPacketProperties,
  [out]     PACKET_PROPERTY   **ppPacketProperties
);

パラメーター

[in] tcid

タブレット コンテキスト識別子を指定します。

[in, out] pfInkToDeviceScaleX

インク空間からデジタイザー座標への横軸の変換係数を指定します。

[in, out] pfInkToDeviceScaleY

インク空間からデジタイザー座標への縦軸の変換係数を指定します。

[in, out] pcPacketProperties

各パケット内のプロパティの数。

[out] ppPacketProperties

各パケット プロパティの GUID とプロパティ メトリックを含む配列へのポインター。

戻り値

戻り値の説明については、「 RealTimeStylus クラスとインターフェイス」を参照してください。

注釈

スケーリング パラメーターが不要な場合は 、NULL を 渡すことができます。

IRealTimeStylus::GetPacketDescriptionData メソッドは、CoTaskMemAlloc を使用して ppPacketProperties の領域を割り当てます。 配列が不要になった場合、呼び出し元は CoTaskMemFree を呼び出す必要があります。

プラグインに送信されるデータ ストリーム内のプロパティの順序は、 IRealTimeStylus::GetPacketDescriptionData メソッドによって返されるプロパティの順序と同じです。 このメソッドを使用して、 IRealTimeStylus::SetDesiredPacketDescription メソッドを呼び出すときに要求されたハードウェアと何を報告するかを判断します。

例

この C++ コード例では、 IRealTimeStylus::GetPacketDescriptionData メソッドメソッド を使用して、インク パケット データに関する情報を取得します。

STDMETHODIMP CCustomRenderer::StylusUp( 
            /* [in] */ IRealTimeStylus *piRtsSrc,
            /* [in] */ const StylusInfo *pStylusInfo,
            /* [in] */ ULONG cPropCountPerPkt,
            /* [size_is][in] */ LONG *pPacket,
            /* [out][in] */ LONG **ppInOutPkt)
{
TABLET_CONTEXT_ID *pTcids;
ULONG ulTcidCount;
TABLET_CONTEXT_ID tcid;
FLOAT fInkToDeviceScaleX;
FLOAT fInkToDeviceScaleY;
ULONG ulPacketProperties;
PACKET_PROPERTY *pPacketProperties;

// Get all the tablet context identifiers
HRESULT hr = piRtsSrc->GetAllTabletContextIds(&ulTcidCount, &pTcids);

// Use the first tablet context identifier in the array
tcid = *pTcids;

// Get the packet description data
hr = piRtsSrc->GetPacketDescriptionData(tcid, &fInkToDeviceScaleX, 
                                        &fInkToDeviceScaleY, &ulPacketProperties,
                                        &pPacketProperties);

// Use the packet description data to do things like scale the ink 
// to the physical display device when rendering your own strokes

	return S_OK;
}

要件

要件	値
サポートされている最小のクライアント	Windows XP タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	rtscom.h
[DLL]	RTSCom.dll

こちらもご覧ください

IRealTimeStylus

IRealTimeStylus::GetDesiredPacketDescription メソッド

IRealTimeStylus::SetDesiredPacketDescription メソッド

RealTimeStylus クラス