Método IRealTimeStylus::GetPacketDescriptionData (rtscom.h)

Artigo
03/01/2024

Recupera as propriedades do pacote e os fatores de dimensionamento.

Sintaxe

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

Parâmetros

[in] tcid

Especifica o identificador de contexto do tablet.

[in, out] pfInkToDeviceScaleX

Especifica o fator de conversão para o eixo horizontal, do espaço à tinta para as coordenadas do digitalizador.

[in, out] pfInkToDeviceScaleY

Especifica o fator de conversão para o eixo vertical, do espaço à tinta para as coordenadas do digitalizador.

[in, out] pcPacketProperties

O número de propriedades em cada pacote.

[out] ppPacketProperties

Ponteiro para uma matriz que contém guids e métricas de propriedade para cada propriedade de pacote.

Retornar valor

Para obter uma descrição dos valores retornados, consulte Classes e interfaces RealTimeStylus.

Comentários

Você poderá passar NULL se não quiser os parâmetros de dimensionamento.

O método IRealTimeStylus::GetPacketDescriptionData usa CoTaskMemAlloc para alocar espaço para ppPacketProperties. O chamador deve chamar CoTaskMemFree quando a matriz não for mais necessária.

A ordem das propriedades no fluxo de dados enviados para plug-ins é a mesma que a ordem das propriedades retornadas pelo Método IRealTimeStylus::GetPacketDescriptionData. Use esse método para determinar o que o hardware está relatando versus o que foi solicitado ao chamar o Método IRealTimeStylus::SetDesiredPacketDescription.

Exemplos

Este exemplo de código C++ usa o método método IRealTimeStylus::GetPacketDescriptionData para obter informações sobre os dados do pacote de tinta.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	rtscom.h
DLL	RTSCom.dll