phoneSetDisplay 函式 (tapi.h)

發行項
03/02/2024

phoneSetDisplay 函式會導致指定的字串顯示在指定的開啟手機裝置上。

語法

LONG phoneSetDisplay(
  HPHONE hPhone,
  DWORD  dwRow,
  DWORD  dwColumn,
  LPCSTR lpsDisplay,
  DWORD  dwSize
);

參數

hPhone

開啟手機裝置的句柄。應用程式必須是手機的擁有者。

dwRow

顯示新文字所在的顯示列位置。

dwColumn

要顯示新文字之顯示器上的數據行位置。

lpsDisplay

儲存顯示內容的記憶體位置指標。顯示信息必須具有 PHONECAPS 結構的 dwStringFormat 成員中指定的格式，其描述手機的裝置功能。

dwSize

lpsDisplay 所指向的資訊大小，以位元組為單位。如果 lpsDisplay 參數是字串的指標，則大小必須包含 Null 終止符。

傳回值

如果函式是以異步方式完成，則傳回正向要求標識符，如果發生錯誤，則傳回負錯誤號碼。如果函式成功，則對應PHONE_REPLY訊息的 dwParam2 參數為零，如果發生錯誤，則為負錯誤號碼。可能的傳回值為：

PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NOTOWNER、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPHONESTATE、PHONEERR_UNINITIALIZED、PHONEERR_INVALPOINTER、PHONEERR_NOMEM、PHONEERR_INVALPARAM、PHONEERR_RESOURCEUNAVAIL。

備註

指定的顯示資訊會從指定的位置開始寫入手機的顯示器。這項作業會覆寫先前顯示的資訊。如果資訊量超過顯示的大小，則會截斷資訊。可顯示的資訊量最多 (dwNumRows * dwNumColumns) 大小元素。 dwNumRows 和 dwNumColumns 位於 PHONECAPS 結構中，由 phoneGetDevCaps 傳回;它們是以零起始的。