nf-control-ibasicaudio-get_volume.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:control.IBasicAudio.get_Volume	IBasicAudio::get_Volume (control.h)	The get_Volume method retrieves the volume (amplitude) of the audio signal.	IBasicAudio interface [DirectShow] get_Volume method IBasicAudio.get_Volume IBasicAudio::get_Volume IBasicAudioget_Volume control/IBasicAudio::get_Volume dshow.ibasicaudio_get_volume get_Volume get_Volume method [DirectShow] get_Volume method [DirectShow] IBasicAudio interface	dshow\ibasicaudio_get_volume.htm	dshow	3258da5a-ab44-4c8a-813b-79a0c28693a3	4/26/2023	IBasicAudio interface [DirectShow],get_Volume method, IBasicAudio.get_Volume, IBasicAudio::get_Volume, IBasicAudioget_Volume, control/IBasicAudio::get_Volume, dshow.ibasicaudio_get_volume, get_Volume, get_Volume method [DirectShow], get_Volume method [DirectShow],IBasicAudio interface	control.h	Dshow.h	Windows	Windows 2000 Professional [desktop apps only]	Windows 2000 Server [desktop apps only]										Strmiids.lib			Windows			19H1	IBasicAudio::get_Volume control/IBasicAudio::get_Volume	c++	APIRef kbSyntax	COM	Strmiids.lib Strmiids.dll	IBasicAudio.get_Volume

IBasicAudio::get_Volume

-description

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The get_Volume method retrieves the volume (amplitude) of the audio signal.

-parameters

-param plVolume [out]

Pointer to a variable that receive the volume. Divide by 100 to get equivalent decibel value. For example, –10,000 is –100 dB.

-returns

Returns an HRESULT value. Possible values include the following.

Return code	Description
E_NOTIMPL	The filter graph does not contain an audio renderer filter. (Possibly the source does not contain an audio stream.)
E_POINTER	NULL pointer argument.
S_OK	Success.

-see-also

Error and Success Codes

IBasicAudio Interface