|
auxGetVolume
The auxGetVolume function retrieves the current volume setting of the specified auxiliary
output device.
MMRESULT auxGetVolume(
UINT uDeviceID,
|
| LPDWORD lpdwVolume
|
| );
|
|
Parameters
uDeviceID
Identifier of the auxiliary output device to be queried.
lpdwVolume
Address of a variable to be filled with the current volume setting. The
low-order word of this location contains the left channel volume setting, and the
high-order word contains the right channel setting. A value of 0xFFFF represents
full volume, and a value of 0x0000 is silence.
If a device does not support both left and right volume control, the low-order
word of the specified location contains the volume level.
The full 16-bit setting(s) set with the auxSetVolume function are returned, regardless of whether the device supports the full 16
bits of volume-level control.
Return Values
Returns MMSYSERR_NOERROR if successful or an error otherwise. Possible error
values include the following:
MMSYSERR_BADDEVICEID
| Specified device identifier is out of range.
|
Remarks
Not all devices support volume control. To determine whether a device supports
volume control, use the AUXCAPS_VOLUME flag to test the dwSupport member of the AUXCAPS structure (filled by the auxGetDevCaps function).
To determine whether a device supports volume control on both the left and
right channels, use the AUXCAPS_LRVOLUME flag to test the dwSupport member of the AUXCAPS structure (filled by auxGetDevCaps).
See Also
auxSetVolume, AUXCAPS, auxGetDevCaps
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Programmer's Reference (win32.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
