phoneGetRing 函式 (tapi.h)

phoneGetRing 函式可讓應用程式查詢指定的開啟手機裝置，以取得其目前的通道模式。

語法

LONG phoneGetRing(
  HPHONE  hPhone,
  LPDWORD lpdwRingMode,
  LPDWORD lpdwVolume
);

參數

hPhone

開啟手機裝置的句柄。

lpdwRingMode

手機響鈴的響鈴模式。 零表示手機未響鈴。

lpdwVolume

手機響鈴的音量層級。 這是0x00000000 (无声) 範圍中的數位，可0x0000FFFF (最大音量) 。 此範圍中磁碟區設定的實際粒度和量化是服務提供者特定的。

傳回值

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

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

備註

服務提供者會定義與每個手機響鈴模式對應的實際音訊響鈴模式。

規格需求

另請參閱

補充電話服務功能

TAPI 2.2 參考概觀