Estructura PHONESTATUS (tapi.h)

La estructura PHONESTATUS describe el estado actual de un dispositivo telefónico. Las funciones phoneGetStatus y TSPI_phoneGetStatus devuelven esta estructura.

Sintaxis

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;

Miembros

dwTotalSize

Tamaño total asignado a esta estructura de datos, en bytes.

dwNeededSize

Tamaño de esta estructura de datos necesaria para contener toda la información devuelta, en bytes.

dwUsedSize

Tamaño de la parte de esta estructura de datos que contiene información útil, en bytes.

dwStatusFlags

Marcas de estado para este dispositivo telefónico. Este miembro usa una de las constantes de PHONESTATUSFLAGS_.

dwNumOwners

Número de módulos de aplicación con privilegios de propietario para el teléfono.

dwNumMonitors

Número de módulos de aplicación con privilegios de supervisión para el teléfono.

dwRingMode

Modo de anillo actual de un dispositivo telefónico.

dwRingVolume

Volumen de anillo actual de un dispositivo telefónico. Se trata de un valor entre 0x00000000 (silencio) y 0x0000FFFF (volumen máximo).

dwHandsetHookSwitchMode

Modo de ganchos de corriente del teléfono. Este miembro usa una de las PHONEHOOKSWITCHMODE_ Constantes.

dwHandsetVolume

Volumen actual del altavoz del dispositivo del teléfono. Se trata de un valor entre 0x00000000 (silencio) y 0x0000FFFF (volumen máximo).

dwHandsetGain

Ganancia de micrófono actual del dispositivo del teléfono. Se trata de un valor entre 0x00000000 (silencio) y 0x0000FFFF (ganancia máxima).

dwSpeakerHookSwitchMode

Modo de enlace actual del altavoz del teléfono. Este miembro usa una de las PHONEHOOKSWITCHMODE_ Constantes.

dwSpeakerVolume

Volumen actual del altavoz del dispositivo del altavoz del teléfono. Se trata de un valor entre 0x00000000 (silencio) y 0x0000FFFF (volumen máximo).

dwSpeakerGain

Ganancia de micrófono actual del dispositivo del altavoz del teléfono. Se trata de un valor entre 0x00000000 (silencio) y 0x0000FFFF (ganancia máxima).

dwHeadsetHookSwitchMode

Modo de enlace actual del casco del teléfono. Este miembro usa una de las PHONEHOOKSWITCHMODE_ Constantes.

dwHeadsetVolume

Volumen actual del altavoz del dispositivo de auriculares del teléfono. Se trata de un valor entre 0x00000000 (silencio) y 0x0000FFFF (volumen máximo).

dwHeadsetGain

Ganancia de micrófono actual del dispositivo de auriculares del teléfono. Se trata de un valor entre 0x00000000 (silencio) y 0x0000FFFF (ganancia máxima).

dwDisplaySize

Tamaño de la información de presentación, en bytes.

dwDisplayOffset

Desplazamiento desde el principio de esta estructura hasta el campo de tamaño variable que contiene la información de visualización actual del teléfono. DwDisplaySize especifica el tamaño del campo.

dwLampModesSize

Tamaño de la matriz de modos de lámpara actual, en bytes.

dwLampModesOffset

Desplazamiento desde el principio de esta estructura hasta el campo de tamaño variable que contiene los modos de lámpara actuales del teléfono. DwLampModesSize especifica el tamaño del campo.

dwOwnerNameSize

Tamaño del nombre del propietario actual, incluido el terminador null , en bytes.

dwOwnerNameOffset

Desplazamiento desde el principio de la estructura hasta el campo de tamaño variable que contiene el nombre de la aplicación que es el propietario actual del dispositivo telefónico. El nombre es el nombre de la aplicación proporcionado por la aplicación cuando se invoca con phoneInitialize o phoneInitializeEx. Si no se proporcionó ningún nombre de aplicación, se usa el nombre de archivo de la aplicación en su lugar. DwOwnerNameSize especifica el tamaño del campo. Si el teléfono no tiene actualmente ningún propietario, dwOwnerNameSize es cero.

dwDevSpecificSize

Tamaño del campo específico del dispositivo, en bytes. Si la información específica del dispositivo es un puntero a una cadena, el tamaño debe incluir el terminador null .

dwDevSpecificOffset

Desplazamiento desde el principio de esta estructura hasta el campo específico del dispositivo de tamaño variable. DwDevSpecificSize especifica el tamaño del campo.

dwPhoneFeatures

Marcas que indican qué funciones de API de telefonía se pueden invocar en el teléfono, teniendo en cuenta la disponibilidad de la característica en las funcionalidades del dispositivo, el estado actual del dispositivo y la propiedad del dispositivo de la aplicación invocada. Un cero indica que la aplicación no puede invocar la característica correspondiente en el teléfono en su estado actual; una indica que se puede invocar la característica. Este miembro usa una o varias de las constantes de PHONEFEATURE_.

Comentarios

Las extensiones específicas del dispositivo deben usar el área de tamaño variable DevSpecific (dwDevSpecificSize y dwDevSpecificOffset) de esta estructura de datos.

El miembro dwPhoneFeatures solo está disponible para las aplicaciones que abren el dispositivo telefónico con una versión de API de 2.0 o posterior.

Requisitos

Requisito	Valor
Header	tapi.h

Consulte también

TSPI_phoneGetStatus

phoneGetStatus

phoneInitialize

phoneInitializeEx