Función phoneSetRing (tapi.h)

Artículo
03/13/2024

La función phoneSetRing suena el dispositivo telefónico abierto especificado mediante el modo de anillo y el volumen especificados.

Sintaxis

LONG phoneSetRing(
  HPHONE hPhone,
  DWORD  dwRingMode,
  DWORD  dwVolume
);

Parámetros

hPhone

Controle el dispositivo de teléfono abierto. La aplicación debe ser el propietario del dispositivo telefónico.

dwRingMode

Patrón de llamada con el que llamar al teléfono. Este parámetro debe estar dentro del intervalo de cero al valor del miembro dwNumRingModes en la estructura PHONECAPS . Si dwNumRingModes es cero, no se puede controlar el modo de anillo del teléfono; si dwNumRingModes es 1, un valor de 0 para dwRingMode indica que el teléfono no debe ser rung (silencio) y otros valores de 1 a dwNumRingModes son modos de llamada válidos para el dispositivo telefónico.

dwVolume

Nivel de volumen con el que el teléfono está sonando. 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 de volumen de este intervalo son específicas del proveedor de servicios. Un valor de dwVolume que está fuera del intervalo se establece en el valor más cercano del intervalo.

Valor devuelto

Devuelve un identificador de solicitud positivo si la función se completa de forma asincrónica o un número de error negativo si se produce un error. El parámetro dwParam2 del mensaje de PHONE_REPLY correspondiente es cero si la función se ejecuta correctamente o es un número de error negativo si se produce un error. Los valores devueltos posibles son:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_NOTOWNER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALRINGMODE, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.