Función phoneGetGain (tapi.h)

  • Artículo

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

Consulte también

Funciones complementarias del servicio telefónico

Introducción a la referencia de TAPI 2.2