Compartir a través de


Función phoneSetGain (tapi.h)

La función phoneSetGain establece la ganancia del micrófono del dispositivo hookswitch especificado en el nivel de ganancia especificado.

Sintaxis

LONG phoneSetGain(
  HPHONE hPhone,
  DWORD  dwHookSwitchDev,
  DWORD  dwGain
);

Parámetros

hPhone

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

dwHookSwitchDev

Dispositivo hookswitch cuya ganancia del micrófono se va a establecer. Este parámetro usa uno y solo uno de los PHONEHOOKSWITCHDEV_ Constantes.

dwGain

Puntero a un DWORD que contiene la nueva configuración de ganancia del dispositivo. El parámetro dwGain especifica el nivel de ganancia 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 de ganancia en este intervalo son específicas del proveedor de servicios. Un valor para dwGain 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