phoneGetDisplay 函式 (tapi.h)

發行項
08/26/2023

phoneGetDisplay函式會傳回指定手機顯示器的目前內容。

語法

LONG phoneGetDisplay(
  HPHONE      hPhone,
  LPVARSTRING lpDisplay
);

參數

hPhone

開啟手機裝置的控制碼。

lpDisplay

要儲存顯示內容的記憶體位置指標，類型為 VARSTRING。

傳回值

如果要求成功或發生錯誤，則傳回零。可能的傳回值為：

PHONEERR_INVALPHONEHANDLE、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPOINTER、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPHONESTATE、PHONEERR_STRUCTURETOOSMALL、PHONEERR_OPERATIONUNAVAIL、PHONEERR_UNINITIALIZED PHONEERR_NOMEM。

備註

lpDisplay記憶體區域至少應 (dwDisplayNumRows * dwDisplayNumColumns) 大小的專案，以接收所有顯示資訊。 dwDisplayNumRows和dwDisplayNumColumns成員可在phoneGetDevCaps傳回的PHONECAPS結構中使用。