función TSPI_phoneSetRing (tspi.h)
La función TSPI_phoneSetRing suena el dispositivo telefónico abierto especificado mediante el modo de anillo y el volumen especificados.
Sintaxis
LONG TSPIAPI TSPI_phoneSetRing(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwRingMode,
DWORD dwVolume
);
Parámetros
dwRequestID
Identificador de la solicitud asincrónica.
hdPhone
Identificador del teléfono que se va a colgar.
dwRingMode
Patrón de timbre con el que llamar al teléfono. Este parámetro debe estar dentro del intervalo comprendido entre cero y el 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 anillo válidos para el dispositivo telefónico.
dwVolume
Nivel de volumen con el que se va a poner 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. Tapi fija un valor para dwVolume que está fuera del intervalo en el valor más cercano del intervalo.
Valor devuelto
Devuelve dwRequestID o un número de error si se produce un error. El parámetro real lResult del ASYNC_COMPLETION correspondiente es cero si la función se realiza correctamente o es 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_INVALRINGMODE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
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
| Plataforma de destino | Windows |
| Encabezado | tspi.h |