Función phoneGetGain (tapi.h)
La función phoneGetGain devuelve la configuración de ganancia del micrófono del dispositivo hookswitch del teléfono especificado.
Sintaxis
LONG phoneGetGain(
HPHONE hPhone,
DWORD dwHookSwitchDev,
LPDWORD lpdwGain
);
Parámetros
hPhone
Controla el dispositivo telefónico abierto.
dwHookSwitchDev
Dispositivo hookswitch cuyo nivel de ganancia se consulta. El parámetro dwHookSwitchDev solo puede tener un conjunto de bits. Este parámetro usa uno y solo uno de los PHONEHOOKSWITCHDEV_ Constantes.
lpdwGain
Puntero a un DWORD que contiene la configuración de ganancia actual del componente de micrófono hookswitch. El parámetro dwGain 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 de ganancia en este intervalo son específicas del proveedor de servicios.
Valor devuelto
Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, 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 |