función TSPI_phoneSetVolume (tspi.h)
La función TSPI_phoneSetVolume establece el volumen del componente de altavoz del dispositivo hookswitch especificado en el nivel especificado.
Sintaxis
LONG TSPIAPI TSPI_phoneSetVolume(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
DWORD dwHookSwitchDev,
DWORD dwVolume
);
Parámetros
dwRequestID
Identificador de la solicitud asincrónica.
hdPhone
Identificador del teléfono que contiene el altavoz cuyo volumen se va a establecer.
dwHookSwitchDev
Identifica el dispositivo hookswitch cuyo volumen del altavoz se va a establecer. Este parámetro usa una de las constantes PHONEHOOKSWITCHDEV_.
dwVolume
DWORD que especifica el nuevo nivel de volumen del dispositivo hookswitch. 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_INVALHOOKSWITCHDEV, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Observaciones
Ninguno.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |