Función phoneGetRing (tapi.h)

  • Artículo

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

Consulte también

Funciones complementarias del servicio telefónico

Introducción a la referencia de TAPI 2.2