función TSPI_phoneGetStatus (tspi.h)
La función TSPI_phoneGetStatus consulta el dispositivo telefónico abierto especificado para su estado general.
Sintaxis
LONG TSPIAPI TSPI_phoneGetStatus(
HDRVPHONE hdPhone,
LPPHONESTATUS lpPhoneStatus
);
Parámetros
hdPhone
Identificador del teléfono que se va a consultar.
lpPhoneStatus
Puntero a una estructura de datos de tamaño variable de tipo PHONESTATUS, en la que el proveedor de servicios escribe información sobre el estado del teléfono. Antes de llamar a TSPI_phoneGetStatus, la aplicación establece el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.
Valor devuelto
Devuelve cero si la función se realiza correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Comentarios
En la tabla siguiente se indican los miembros de la estructura de datos PHONESTATUS rellenados por TAPI y qué miembros rellena el proveedor de servicios. El proveedor de servicios no debe sobrescribir los valores rellenados por TAPI.
| Miembro | TAPI | Proveedor de servicios |
|---|---|---|
| dwTotalSize; | X | |
| dwNeededSize; | X | |
| dwUsedSize; | X | |
| dwStatusFlags; | X | |
| dwNumOwners; | X | |
| dwNumMonitors; | X | |
| dwRingMode; | X | |
| dwRingVolume; | X | |
| dwHandsetHookSwitchMode; | X | |
| dwHandsetVolume; | X | |
| dwHandsetGain; | X | |
| dwSpeakerHookSwitchMode; | X | |
| dwSpeakerVolume; | X | |
| dwSpeakerGain; | X | |
| dwHeadsetHookSwitchMode; | X | |
| dwHeadsetVolume; | X | |
| dwHeadsetGain; | X | |
| dwDisplaySize; | X | |
| dwDisplayOffset; | X | |
| dwLampModesSize; | X | |
| dwLampModesOffset; | X | |
| dwOwnerNameSize; | X | |
| dwOwnerNameOffset; | X | |
| dwDevSpecificSize; | X | |
| dwDevSpecificOffset; | X |
TAPI puede usar esta función para determinar el estado actual de un dispositivo telefónico abierto. La información de estado describe información sobre los dispositivos hookswitch del dispositivo telefónico, el timbre, el volumen, la pantalla y las lámparas del teléfono abierto.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |