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

另請參閱

TSPI_phoneGetStatus

phoneGetStatus

phoneInitialize

phoneInitializeEx