IMFPMediaPlayer::SetBalance method (mfplay.h)

Important Deprecated. This API may be removed from future releases of Windows. Applications should use the Media Session for playback.

Sets the audio balance.

Syntax

HRESULT SetBalance(
  [in] float flBalance
);

[in] flBalance

The audio balance. The value can be any number in the following range (inclusive).

Value	Meaning
-1.0	The left channel is at full volume; the right channel is silent.
+1.0	The right channel is at full volume; the left channel is silent.

If the value is zero, the left and right channels are at equal volumes. The default value is zero.

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code	Description
S_OK	The method succeeded.
MF_E_OUT_OF_RANGE	The flBalance parameter is invalid.

If you call this method before playback starts, the setting is applied when playback starts.

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	mfplay.h