共用方式為

getPreferredPacketDescription 函式 (recapis.h)

  • 發行項

擷取封包描述，其中包含辨識器所使用的封包屬性。

語法

HRESULT GetPreferredPacketDescription(
  HRECOGNIZER        hrec,
  PACKET_DESCRIPTION *pPacketDescription
);

參數

hrec

辨識器的句柄。

pPacketDescription

描述辨識器所使用的封包內容。 如需詳細資訊，請參閱 PACKET_DESCRIPTION 結構。

若要擷取封包描述，請使用零初始化封包描述，並呼叫 GetPreferredPacketDescription 函 式。 函式會填入屬性和按鈕計數，您用來為 PACKET_DESCRIPTION 結構的 pPacketProperties 和 pguidButtons 成員配置空間。 再次呼叫 函式以填入封包描述的其餘部分。

當 GetPreferredPacketDescription 傳回時，PACKET_DESCRIPTION 結構的 pguidButtons 成員可能是零。 這表示封包沒有按鈕數據，因此此成員沒有配置任何 pguidButtons。 在此情況下，呼叫函式應該會保留指標 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結構