phoneSetRing 函式 (tapi.h)

發行項
03/02/2024

phoneSetRing 函式會使用指定的通道模式和音量來響鈴指定的已開啟手機裝置。

語法

LONG phoneSetRing(
  HPHONE hPhone,
  DWORD  dwRingMode,
  DWORD  dwVolume
);

參數

hPhone

開啟手機裝置的句柄。應用程式必須是手機裝置的擁有者。

dwRingMode

用來撥打電話的響鈴模式。此參數的範圍必須是零到 PHONECAPS 結構中 dwNumRingModes 成員的值。如果 dwNumRingModes 為零，則無法控制手機的通道模式;如果 dwNumRingModes 為 1，dwRingMode 的值為 0 表示手機不應該在無聲 (無聲) 執行，而從 1 到 dwNumRingModes 的其他值是手機裝置的有效環形模式。

dwVolume

電話響鈴的音量層級。這是0x00000000 (无声范围中的数字，) 0x0000FFFF (最大音量) 。此範圍中磁碟區設定的實際粒度和量化是服務提供者特定的。 超出範圍的 dwVolume 值會設定為範圍中最接近的值。

傳回值

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

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_NOTOWNER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALRINGMODE、PHONEERR_UNINITIALIZED PHONEERR_OPERATIONUNAVAIL。