Compartir a través de


TSPI_phoneSetGain función (tspi.h)

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

Sintaxis

LONG TSPIAPI TSPI_phoneSetGain(
  DRV_REQUESTID dwRequestID,
  HDRVPHONE     hdPhone,
  DWORD         dwHookSwitchDev,
  DWORD         dwGain
);

Parámetros

dwRequestID

Identificador de la solicitud asincrónica.

hdPhone

Identificador del teléfono que contiene el dispositivo hookswitch cuya ganancia se va a establecer.

dwHookSwitchDev

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

dwGain

Una ubicación de tamaño DWORD que contiene la nueva configuración de ganancia deseada del dispositivo. Se trata de un número del intervalo desde 0x00000000 (silencio) hasta 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. Tapi fija un valor para dwGain que está fuera del intervalo al valor más cercano dentro 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 ejecuta 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.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado tspi.h

Consulte también

ASYNC_COMPLETION

PHONECAPS

TSPI_phoneGetDevCaps