IRealTimeStylus::GetPacketDescriptionData 메서드(rtscom.h)

아티클
08/25/2023

패킷 속성 및 크기 조정 요소를 검색합니다.

구문

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