IInkStrokeDisp::GetPacketData 메서드(msinkaut.h)

아티클
08/25/2023

IInkStrokeDisp 개체 내의 패킷 범위에 대한 패킷 데이터를 검색합니다.

구문

HRESULT GetPacketData(
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketData
);

매개 변수

[in, optional] Index

선택 사항입니다. 스트로크 내의 패킷에 대한 0부터 시작하는 인덱스의 시작점입니다. InkSelectionConstants 열거형 형식에 정의된 기본값 ISC_FirstElement 첫 번째 패킷을 지정합니다.

[in, optional] Count

선택 사항입니다. startingIndex 매개 변수에 지정된 패킷부터 시작하여 반환해야 하는 점 패킷 데이터 집합의 수입니다. InkSelectionConstants 열거형 형식에 정의된 기본값 ISC_AllElements 스트로크 데이터를 구성하는 모든 점을 지정합니다.

[out, retval] PacketData

이 메서드가 반환되면 는 스트로크에서 요청된 지점에 대한 패킷 데이터를 포함하는 서명된 32비트 정수 배열을 포함합니다. 배열에는 첫 번째 점의 데이터, 두 번째 점의 데이터 등이 포함됩니다.

VARIANT 구조에 대한 자세한 내용은 COM 라이브러리 사용을 참조하세요.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	성공.
E_POINTER	매개 변수에 잘못된 포인터가 포함되어 있습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_OUTOFMEMORY	Stroke 처리기 도우미 개체를 할당할 수 없습니다.
E_INVALIDARG	스트로크가 잘못되었습니다.
E_INK_EXCEPTION	메서드 내에서 예외가 발생했습니다.
E_UNEXPECTED	예기치 않은 매개 변수 또는 속성 형식입니다.

설명

스트로크의 패킷 수가 startingIndex 및 pointCount 매개 변수의 합계보다 작은 경우 반환된 데이터 배열에는 요청된 개수보다 적은 수의 지점에 대한 패킷 정보가 포함됩니다.

패킷 데이터에 대한 설명을 검색하려면 스트로크의 PacketDescription 속성을 사용합니다. 이 속성은 각 지점에 대해 GetPacketData 메서드에서 반환되는 속성 값을 나타내는 GUID(Globally Unique Identifier) 배열을 반환합니다. PacketProperty 상수에는 사용 가능한 패킷 속성 GUID가 포함됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	msinkaut.h
라이브러리	InkObj.dll