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 |