phoneSetData 函式 (tapi.h)

phoneSetData函式會將指定緩衝區中的資訊下載到所選取資料識別碼的已開啟手機裝置。

語法

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

參數

hPhone

開啟手機裝置的控制碼。 應用程式必須是手機的擁有者。

dwDataID

在手機裝置中，要下載緩衝區的位置。

lpData

要從中下載資料的記憶體位置指標。

dwSize

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

傳回值

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

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

備註

phoneSetData函式會將最大 dwSize位元組從lpData下載到手機裝置。 資料的格式、對手機裝置的意義，以及資料識別碼的意義是服務提供者特定的。 緩衝區中的資料或資料識別碼選取範圍中的資料，可作為手機裝置的命令。

規格需求

另請參閱

PHONE_REPLY

補充電話語音功能

TAPI 2.2 參考概觀