Compartir a través de


TSPI_phoneGetVolume función (tspi.h)

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

Sintaxis

LONG TSPIAPI TSPI_phoneGetVolume(
  HDRVPHONE hdPhone,
  DWORD     dwHookSwitchDev,
  LPDWORD   lpdwVolume
);

Parámetros

hdPhone

Identificador del teléfono que contiene el dispositivo hookswitch cuya configuración de volumen se va a recuperar.

dwHookSwitchDev

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

lpdwVolume

Puntero a una ubicación de tamaño DWORD en la que el proveedor de servicios escribe la configuración de volumen actual del dispositivo hookswitch. 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 del volumen en este intervalo son específicas del proveedor de servicios.

Valor devuelto

Devuelve cero si la función se realiza 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

Requisito Value
Plataforma de destino Windows
Encabezado tspi.h

Consulte también

PHONECAPS

TSPI_phoneGetDevCaps

TSPI_phoneSetVolume