GetPreferredPacketDescription 함수(recapis.h)

인식기에서 사용하는 패킷 속성이 포함된 패킷 설명을 검색합니다.

구문

HRESULT GetPreferredPacketDescription(
  HRECOGNIZER        hrec,
  PACKET_DESCRIPTION *pPacketDescription
);

매개 변수

hrec

인식기 핸들입니다.

pPacketDescription

인식기에서 사용하는 패킷의 내용을 설명합니다. 자세한 내용은 PACKET_DESCRIPTION 구조를 참조하세요.

패킷 설명을 검색하려면 패킷 설명을 0으로 초기화하고 GetPreferredPacketDescription 함수를 호출합니다. 함수는 PACKET_DESCRIPTION 구조체 의 pPacketProperties 및 pguidButtons 멤버에 대한 공간을 할당하는 데 사용하는 속성 및 단추 수를 채웁니다. 함수를 다시 호출하여 패킷 설명의 나머지 부분을 채웁다.

GetPreferredPacketDescription이 반환될 때 PACKET_DESCRIPTION 구조체의 pguidButtons 멤버는 0일 수 있습니다. 즉, 패킷에 단추 데이터가 없으므로 이 멤버에 할당된 pguidButton이 없습니다. 이 경우 호출 함수는 포인터 NULL을 유지해야 합니다.

반환 값

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

반환 코드	Description
S_OK	성공.
E_POINTER	매개 변수가 잘못된 포인터입니다.
TPC_E_INSUFFICIENT_BUFFER	pPacketDescription 버퍼가 너무 작습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_INVALIDARG	잘못된 인수가 수신되었습니다.

설명

일반적으로 인식기는 (x, y) 좌표 속성을 사용하고 다른 속성을 무시합니다. 나중에 인식할 수 있도록 파일에 잉크를 저장하는 경우 기본 패킷 설명을 사용하여 인식기에서 사용하는 속성만 저장합니다.

요구 사항

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

추가 정보

AddStroke 함수

PACKET_DESCRIPTION 구조체