función TSPI_phoneGetRing (tspi.h)
La función TSPI_phoneGetRing permite a una aplicación consultar el dispositivo telefónico abierto especificado en cuanto a su modo de anillo actual.
Sintaxis
LONG TSPIAPI TSPI_phoneGetRing(
HDRVPHONE hdPhone,
LPDWORD lpdwRingMode,
LPDWORD lpdwVolume
);
Parámetros
hdPhone
Identificador del teléfono cuyo modo de llamada se va a consultar.
lpdwRingMode
El patrón de timbre con el que el teléfono está sonando. Cero indica que el teléfono no está sonando.
lpdwVolume
Nivel de volumen con el que suena el teléfono. Se trata de un número en el intervalo desde 0x00000000 (silencio) hasta 0x0000FFFF (volumen máximo). La granularidad real y la cuantificación de la configuración del volumen en este intervalo son específicas del proveedor de servicios.
Valor devuelto
Devuelve cero si la función se ejecuta correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Comentarios
El proveedor de servicios define los patrones de llamada audible reales correspondientes a cada uno de los modos de llamada del teléfono.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |