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
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi.h |
| Library | Tapi32.lib |
| Archivo DLL | Tapi32.dll |