función TSPI_phoneGetGain (tspi.h)
La función TSPI_phoneGetGain devuelve la configuración de ganancia del micrófono del dispositivo hookswitch del teléfono especificado.
Sintaxis
LONG TSPIAPI TSPI_phoneGetGain(
HDRVPHONE hdPhone,
DWORD dwHookSwitchDev,
LPDWORD lpdwGain
);
Parámetros
hdPhone
Identificador del teléfono cuya ganancia se va a recuperar.
dwHookSwitchDev
Dispositivo hookswitch cuyo nivel de ganancia se consulta. Este parámetro puede ser uno y solo uno de los PHONEHOOKSWITCHDEV_ Constantes.
lpdwGain
Puntero a una ubicación de tamaño DWORD en la que el proveedor de servicios escribe la configuración de ganancia actual del componente de micrófono hookswitch. El parámetro de ganancia dwGain especifica el nivel de volumen del dispositivo hookswitch. Se trata de un número en el 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.
Valor devuelto
Devuelve cero si la función se ejecuta correctamente o 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
| Plataforma de destino | Windows |
| Encabezado | tspi.h |