TSPI_phoneGetStatus函式 (tspi.h)
TSPI_phoneGetStatus函式會查詢指定的開啟電話裝置是否有其整體狀態。
語法
LONG TSPIAPI TSPI_phoneGetStatus(
HDRVPHONE hdPhone,
LPPHONESTATUS lpPhoneStatus
);
參數
hdPhone
要查詢之電話的句柄。
lpPhoneStatus
PHONESTATUS 類型的可變大小數據結構的指標，服務提供者會將電話狀態的相關信息寫入其中。 在呼叫 TSPI_phoneGetStatus之前，應用程式會設定這個結構的 dwTotalSize 成員，以指出 TAPI 可用來傳回資訊的記憶體數量。
傳回值
如果函式成功，則傳回零，如果發生錯誤，則傳回錯誤號碼。 可能的傳回值如下所示：
PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM、PHONEERR_OPERATIONUNAVAIL、PHONEERR_RESOURCEUNAVAIL。
備註
下表指出 TAPI 填入 PHONESTATUS 數據結構的成員，以及服務提供者填入哪些成員。 服務提供者不得覆寫 TAPI 填入的值。
| 成員 | Tapi | 服務提供者 |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| dwStatusFlags; | X | |
| dwNumOwners; | X | |
| dwNumMonitors; | X | |
| dwRingMode; | X | |
| dwRingVolume; | X | |
| dwHandsetHookSwitchMode; | X | |
| dwHandsetVolume; | X | |
| dwHandsetGain; | X | |
| dwSpeakerHookSwitchMode; | X | |
| dwSpeakerVolume; | X | |
| dwSpeakerGain; | X | |
| dwHeadsetHookSwitchMode; | X | |
| dwHeadsetVolume; | X | |
| dwHeadsetGain; | X | |
| dwDisplaySize; | X | |
| dwDisplayOffset; | X | |
| dwLampModesSize; | X | |
| dwLampModesOffset; | X | |
| dwOwnerNameSize; | X | |
| dwOwnerNameOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
TAPI 可以使用此函式來判斷已開啟手機裝置的目前狀態。 狀態資訊描述手機裝置的勾點、信號器、音量、顯示器和開啟手機的音調的相關信息。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | tspi.h |