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。
備註
服務提供者會定義與每個手機響鈴模式對應的實際音訊響鈴模式。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |