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

Consulte también

PHONE_REPLY

Funciones complementarias del servicio telefónico

Introducción a la referencia de TAPI 2.2