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 |