Platform SDK: TAPI

TSPI_phoneGetVolume

The TSPI_phoneGetVolume function returns the volume setting of the specified phone's hookswitch device.

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

Parameters

hdPhone
The handle to the phone containing the hookswitch device whose volume setting is to be retrieved.
dwHookSwitchDev
Identifies a single hookswitch device whose volume level is queried. This parameter uses one of the PHONEHOOKSWITCHDEV_ constants.
lpdwVolume
A pointer to a DWORD-sized location into which the service provider writes the current volume setting of the hookswitch device. This is a number in the range from 0x00000000 (silence) through 0x0000FFFF (maximum volume). The actual granularity and quantization of volume settings in this range are service-provider specific.

Return Values

Returns zero if the function succeeds, or an error number if an error occurs. Possible return values are as follows:

PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, HONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later.
  Version: Requires TAPI 1.3 or later.
  Header: Declared in Tspi.h.

See Also

PHONECAPS, TSPI_phoneGetDevCaps, TSPI_phoneSetVolume