TSPI_phoneGetData 函数 (tspi.h)

TSPI_phoneGetData函数将信息从打开的电话设备中的指定位置上传到指定的缓冲区。

语法

LONG TSPIAPI TSPI_phoneGetData(
  HDRVPHONE hdPhone,
  DWORD     dwDataID,
  LPVOID    lpData,
  DWORD     dwSize
);

参数

hdPhone

要查询的电话的句柄。

dwDataID

指定在手机设备中上传缓冲区的位置。

lpData

指向数据要上传到的内存缓冲区的指针。

dwSize

数据缓冲区的大小(以字节为单位)。 如果 lpData 参数是指向字符串的指针,则大小必须包含 null 终止符。

返回值

如果函数成功,则返回零;如果发生错误,则返回错误号。 可能的返回值如下所示:

PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONUNAVAIL、PHONEERR_INVALDATAID、PHONEERR_RESOURCEUNAVAIL。

注解

TSPI_phoneGetData函数将最大 dwSize 字节从电话设备上传到 lpData。 如果 dwSize 为零,则不复制任何内容。 手机的 PHONECAPS 结构中列出了每个数据区域的大小。

要求

要求
目标平台 Windows
标头 tspi.h

另请参阅

PHONECAPS

TSPI_phoneGetDevCaps

TSPI_phoneSetData