Función phoneSetVolume (tapi.h)
La función phoneSetVolume establece el volumen del componente de altavoz del dispositivo hookswitch especificado en el nivel especificado.
Sintaxis
LONG phoneSetVolume(
HPHONE hPhone,
DWORD dwHookSwitchDev,
DWORD dwVolume
);
Parámetros
hPhone
Controla el dispositivo telefónico abierto. La aplicación debe ser el propietario del teléfono.
dwHookSwitchDev
Dispositivo hookswitch cuyo volumen del altavoz se va a establecer, una de las PHONEHOOKSWITCHDEV_ constantes.
dwVolume
Nueva configuración de volumen del dispositivo. El parámetro dwVolume especifica el nivel de volumen del dispositivo hookswitch. 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. 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_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi.h |
| Library | Tapi32.lib |
| Archivo DLL | Tapi32.dll |