PHONESTATUS 結構 (tapi.h)
PHONESTATUS 結構描述手機裝置的目前狀態。 phoneGetStatus 和 TSPI_phoneGetStatus 函式會傳回這個結構。
語法
typedef struct phonestatus_tag {
DWORD dwTotalSize;
DWORD dwNeededSize;
DWORD dwUsedSize;
DWORD dwStatusFlags;
DWORD dwNumOwners;
DWORD dwNumMonitors;
DWORD dwRingMode;
DWORD dwRingVolume;
DWORD dwHandsetHookSwitchMode;
DWORD dwHandsetVolume;
DWORD dwHandsetGain;
DWORD dwSpeakerHookSwitchMode;
DWORD dwSpeakerVolume;
DWORD dwSpeakerGain;
DWORD dwHeadsetHookSwitchMode;
DWORD dwHeadsetVolume;
DWORD dwHeadsetGain;
DWORD dwDisplaySize;
DWORD dwDisplayOffset;
DWORD dwLampModesSize;
DWORD dwLampModesOffset;
DWORD dwOwnerNameSize;
DWORD dwOwnerNameOffset;
DWORD dwDevSpecificSize;
DWORD dwDevSpecificOffset;
DWORD dwPhoneFeatures;
} PHONESTATUS, *LPPHONESTATUS;
成員
dwTotalSize
配置給這個數據結構的大小總計，以位元組為單位。
dwNeededSize
此數據結構的大小，需要以位元組為單位來保存所有傳回的資訊。
dwUsedSize
這個數據結構中包含實用資訊的部分大小，以位元組為單位。
dwStatusFlags
此手機裝置的狀態旗標。 此成員會使用其中一個 PHONESTATUSFLAGS_常數。
dwNumOwners
具有手機擁有者許可權的應用程式模組數目。
dwNumMonitors
具有手機監視許可權的應用程式模組數目。
dwRingMode
手機裝置的目前通道模式。
dwRingVolume
手機裝置的目前環形音量。 這是0x00000000 (无声) 與0x0000FFFF (最大音量) 之間的值。
dwHandsetHookSwitchMode
手機手機手機的目前攔截模式。 此成員使用其中一個 PHONEHOOKSWITCHMODE_常數。
dwHandsetVolume
手機手機手機裝置的目前喇叭音量。 這是0x00000000 (无声) 與0x0000FFFF (最大音量) 之間的值。
dwHandsetGain
手機的手機手機裝置目前的麥克風增益。 這是0x00000000 (无声) 和0x0000FFFF (最大增益) 之間的值。
dwSpeakerHookSwitchMode
手機喇叭的目前攔截模式。 此成員使用其中一個 PHONEHOOKSWITCHMODE_常數。
dwSpeakerVolume
手機喇叭裝置的目前喇叭音量。 這是0x00000000 (无声) 與0x0000FFFF (最大音量) 之間的值。
dwSpeakerGain
手機喇叭裝置的目前麥克風增益。 這是0x00000000 (无声) 和0x0000FFFF (最大增益) 之間的值。
dwHeadsetHookSwitchMode
手機頭戴裝置的目前攔截模式。 此成員使用其中一個 PHONEHOOKSWITCHMODE_常數。
dwHeadsetVolume
手機頭戴式裝置的目前喇叭音量。 這是0x00000000 (无声) 與0x0000FFFF (最大音量) 之間的值。
dwHeadsetGain
手機頭戴裝置的目前麥克風增益。 這是0x00000000 (无声) 和0x0000FFFF (最大增益) 之間的值。
dwDisplaySize
顯示資訊的大小，以位元組為單位。
dwDisplayOffset
從這個結構的開頭位移到包含手機目前顯示資訊的可變大小欄位。 欄位的大小是由 dwDisplaySize 所指定。
dwLampModesSize
目前燈光模式陣列的大小，以位元組為單位。
dwLampModesOffset
從這個結構的開頭位移到包含手機目前燈光模式的可變大小字段。 欄位的大小是由 dwLampModesSize 所指定。
dwOwnerNameSize
目前擁有者名稱的大小，包括以位元組為單位的 Null 終止符。
dwOwnerNameOffset
從結構的開頭位移到包含目前手機裝置擁有者之應用程式名稱的可變大小字段。 名稱是應用程式使用 phoneInitialize 或 phoneInitializeEx 叫用時所提供的應用程式名稱。 如果未提供應用程式名稱，則會改用應用程式的檔名。 欄位的大小是由 dwOwnerNameSize 所指定。 如果手機目前沒有擁有者， dwOwnerNameSize 為零。
dwDevSpecificSize
裝置特定欄位的大小，以位元組為單位。 如果裝置特定資訊是字串的指標，大小必須包含 Null 終止符。
dwDevSpecificOffset
從這個結構的開頭位移到可變大小的裝置特定欄位。 欄位的大小是由 dwDevSpecificSize 所指定。
dwPhoneFeatures
旗標，指出哪些電話語音 API 功能可以在手機上叫用，考慮裝置功能的可用性、目前裝置狀態，以及叫用應用程式的裝置擁有權。 零表示手機上的應用程式無法叫用其目前狀態的對應功能;一個表示可以叫用功能。 此成員會使用一或多個 PHONEFEATURE_常數。
備註
裝置特定的延伸模組應該使用 DevSpecific (dwDevSpecificSize 和 dwDevSpecificOffset) 此數據結構的可變大小區域。
dwPhoneFeatures 成員僅適用於以 API 版本 2.0 或更新版本開啟手機裝置的應用程式。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | tapi.h |