phoneSTATUS 结构 (tapi.h)

项目
08/26/2023

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 或更高版本打开手机设备的应用程序。

要求

要求	值
Header	tapi.h

另请参阅

Share via

phoneSTATUS 结构 (tapi.h)

语法

成员

注解

要求

另请参阅

反馈

反馈

其他资源