| Microsoft DirectX 9.0 |
The GetPan method retrieves the relative volume of the left and right audio channels.
Syntax
HRESULT GetPan(
LPLONG plPan
);
Parameters
plPan
Address of a variable that receives the relative volume, in hundredths of a decibel.
Return Values
If the method succeeds, the return value is DS_OK.
If the method fails, the return value may be one of the following error values:
| Return code |
| DSERR_CONTROLUNAVAIL |
| DSERR_INVALIDPARAM |
| DSERR_PRIOLEVELNEEDED |
Remarks
The returned value is measured in hundredths of a decibel (dB), in the range of DSBPAN_LEFT to DSBPAN_RIGHT. These values are defined in Dsound.h as -10,000 and 10,000 respectively. The value DSBPAN_LEFT means the right channel is effectively silent. The value DSBPAN_RIGHT means the left channel is effectively silent. The neutral value is DSBPAN_CENTER, defined as 0, which means that both channels are at full volume. When one channel is attenuated, the other remains at full volume.
The pan control acts cumulatively with the volume control.
Requirements
Header: Declared in dsound.h.
See Also