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 结构中可用。