Función phoneGetVolume (tapi.h)

La función phoneGetVolume devuelve la configuración de volumen del dispositivo hookswitch del teléfono especificado.

Sintaxis

LONG phoneGetVolume(
  HPHONE  hPhone,
  DWORD   dwHookSwitchDev,
  LPDWORD lpdwVolume
);

Parámetros

hPhone

Controle el dispositivo de teléfono abierto.

dwHookSwitchDev

Un único dispositivo hookswitch cuyo nivel de volumen se consulta. Este parámetro usa una de las constantes de PHONEHOOKSWITCHDEV_.

lpdwVolume

Puntero a un DWORD. La función devuelve la configuración de volumen actual del dispositivo hookswitch en esta ubicación. 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 volumen de 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_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Requisitos

Consulte también

Funciones complementarias del servicio telefónico

Información general de referencia de TAPI 2.2