Compartir a través de

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

  • Artículo

Recupera las propiedades del paquete y los factores de escalado.

Sintaxis

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 el identificador de contexto de tableta.

[in, out] pfInkToDeviceScaleX

Especifica el factor de conversión del eje horizontal del espacio de entrada de lápiz a las coordenadas del digitalizador.

[in, out] pfInkToDeviceScaleY

Especifica el factor de conversión del eje vertical del espacio de entrada de lápiz a las coordenadas del digitalizador.

[in, out] pcPacketProperties

Número de propiedades de cada paquete.

[out] ppPacketProperties

Puntero a una matriz que contiene los GUID y las métricas de propiedades para cada propiedad de paquete.

Valor devuelto

Para obtener una descripción de los valores devueltos, vea RealTimeStylus Classes and Interfaces (Clases e interfaces de RealTimeStylus).

Comentarios

Puede pasar NULL si no desea los parámetros de escalado.

El método IRealTimeStylus::GetPacketDescriptionData usa CoTaskMemAlloc para asignar espacio para ppPacketProperties. El autor de la llamada debe llamar a CoTaskMemFree cuando la matriz ya no sea necesaria.

El orden de las propiedades del flujo de datos enviados a los complementos es el mismo que el orden de las propiedades devueltas por IRealTimeStylus::GetPacketDescriptionData Method. Use este método para determinar qué informa el hardware frente a lo que se solicitó al llamar al método IRealTimeStylus::SetDesiredPacketDescription.

Ejemplos

En este ejemplo de código de C++ se usa el método IRealTimeStylus::GetPacketDescriptionData Method para obtener información sobre los datos del paquete de entrada de lápiz.

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 Value
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado rtscom.h
Archivo DLL RTSCom.dll

Consulte también

IRealTimeStylus

IRealTimeStylus::GetDesiredPacketDescription (Método)

IRealTimeStylus::SetDesiredPacketDescription (Método)

Clase RealTimeStylus