Función phoneGetRing (tapi.h)
La función phoneGetRing permite a una aplicación consultar el dispositivo telefónico abierto especificado en cuanto a su modo de anillo actual.
Sintaxis
LONG phoneGetRing(
HPHONE hPhone,
LPDWORD lpdwRingMode,
LPDWORD lpdwVolume
);
Parámetros
hPhone
Controla el dispositivo telefónico abierto.
lpdwRingMode
Patrón de llamada con el que suena el teléfono. Cero indica que el teléfono no suena.
lpdwVolume
Nivel de volumen con el que suena el teléfono. Se trata de un número del intervalo 0x00000000 (silencio) para 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 solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.
Comentarios
El proveedor de servicios define los patrones de llamada audible reales correspondientes a cada uno de los modos de anillo del teléfono.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi.h |
| Library | Tapi32.lib |
| Archivo DLL | Tapi32.dll |