phoneGetData 函式 (tapi.h)

phoneGetData 函式會將資訊從開啟的手機裝置中指定的位置上傳至指定的緩衝區。

語法

LONG phoneGetData(
  HPHONE hPhone,
  DWORD  dwDataID,
  LPVOID lpData,
  DWORD  dwSize
);

參數

hPhone

開啟手機裝置的句柄。

dwDataID

在手機裝置中，要從中上傳緩衝區的位置。

lpData

要上傳數據的記憶體緩衝區指標。

dwSize

數據緩衝區的大小，以位元組為單位。

傳回值

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

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

備註

函式會將來自手機裝置的 dwSize 位元組上限上傳至 lpData 所指向的記憶體區域。 如果 dwSize 為零，則不會複製任何專案。 每個數據區域的大小都會列在手機的裝置功能中。

規格需求

另請參閱

補充電話服務功能

TAPI 2.2 參考概觀