GetPreferredPacketDescription 函数 (recapis.h)

  • 项目

检索包含识别器使用的数据包属性的数据包说明。

语法

HRESULT GetPreferredPacketDescription(
  HRECOGNIZER        hrec,
  PACKET_DESCRIPTION *pPacketDescription
);

参数

hrec

识别器的句柄。

pPacketDescription

描述识别器使用的数据包的内容。 有关详细信息，请参阅 PACKET_DESCRIPTION 结构。

若要检索数据包说明，请使用零初始化数据包说明并调用 GetPreferredPacketDescription 函数。 函数填充属性和按钮计数，用于为 PACKET_DESCRIPTION 结构的 pPacketProperties 和 pguidButtons 成员分配空间。 再次调用 函数以填充数据包说明的其余部分。

当 GetPreferredPacketDescription 返回时，PACKET_DESCRIPTION 结构的 pguidButtons 成员可以为零。 这意味着数据包没有按钮数据，因此此成员没有分配任何 pguidButton。 在这种情况下，调用函数应将指针保留 为 NULL。

返回值

此函数可以返回其中一个值。

返回代码 说明
S_OK
 成功。
E_POINTER
 参数是无效的指针。
TPC_E_INSUFFICIENT_BUFFER
 pPacketDescription 缓冲区太小。
E_FAIL
 发生了未指定的错误。
E_INVALIDARG
 收到无效参数。

注解

通常，识别器使用 (x、y) 坐标属性并忽略其他属性。 如果以后将墨迹保存到文件中以供识别，请使用首选数据包说明来仅保存识别器使用的那些属性。

要求

要求 值
最低受支持的客户端 Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 recapis.h
DLL inkobjcore.dll

另请参阅

AddStroke 函数

PACKET_DESCRIPTION 结构