#include <windows.h>
#define MMNOMCI
#include "mmsystem.h"
#define NOMCIDEV
#include "mmddk.h"
#include "mmsysi.h"
/* -------------------------------------------------------------------------
** External globals
** -------------------------------------------------------------------------
*/
extern DWORD mmwow32Lib;
extern LPSOUNDDEVMSGPROC aux32Message;
/*****************************************************************************
* @doc EXTERNAL AUX
*
* @api UINT | auxGetNumDevs | This function retrieves the number of auxiliary
* output devices present in the system.
*
* @rdesc Returns the number of auxiliary output devices present in the system.
*
* @xref auxGetDevCaps
****************************************************************************/
UINT WINAPI auxGetNumDevs(void)
{
return (UINT)auxOutMessage( 0, AUXDM_GETNUMDEVS, 0L, 0L );
}
/*****************************************************************************
* @doc EXTERNAL AUX
*
* @api UINT | auxGetDevCaps | This function queries a specified
* auxiliary output device to determine its capabilities.
*
* @parm UINT | wDeviceID | Identifies the auxiliary output device to be
* queried. Specify a valid device ID (see the following comments
* section), or use the following constant:
* @flag AUX_MAPPER | Auxiliary audio mapper. The function will
* return an error if no auxiliary audio mapper is installed.
*
* @parm LPAUXCAPS | lpCaps | Specifies a far pointer to an AUXCAPS
* structure. This structure is filled with information about the
* capabilities of the device.
*
* @parm UINT | wSize | Specifies the size of the AUXCAPS structure.
*
* @rdesc Returns zero if the function was successful. Otherwise, it returns
* an error number. Possible error returns are:
* @flag MMSYSERR_BADDEVICEID | Specified device ID is out of range.
* @flag MMSYSERR_NODRIVER | The driver failed to install.
*
* @comm The device ID specified by <p wDeviceID> varies from zero
* to one less than the number of devices present. AUX_MAPPER may
* also be used. Use <f auxGetNumDevs> to determine the number of
* auxiliary devices present in the system.
*
* @xref auxGetNumDevs
****************************************************************************/
UINT WINAPI auxGetDevCaps(UINT wDeviceID, LPAUXCAPS lpCaps, UINT wSize)
{
if (!wSize)
return MMSYSERR_NOERROR;
V_WPOINTER(lpCaps, wSize, MMSYSERR_INVALPARAM);
return (UINT)auxOutMessage(wDeviceID, AUXDM_GETDEVCAPS, (DWORD)lpCaps, (DWORD)wSize);
}
/*****************************************************************************
* @doc EXTERNAL AUX
*
* @api UINT | auxGetVolume | This function returns the current volume
* setting of an auxiliary output device.
*
* @parm UINT | wDeviceID | Identifies the auxiliary output device to be
* queried.
*
* @parm LPDWORD | lpdwVolume | Specifies a far pointer to a location
* 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 <f auxSetVolume> are returned, regardless of whether
* the device supports the full 16 bits of volume level control.
*
* @comm Not all devices support volume control.
* To determine whether the device supports volume control, use the
* AUXCAPS_VOLUME flag to test the <e AUXCAPS.dwSupport> field of the
* <t AUXCAPS> structure (filled by <f auxGetDevCaps>).
*
* To determine whether the device supports volume control on both the
* left and right channels, use the AUXCAPS_LRVOLUME flag to test the
* <e AUXCAPS.dwSupport> field of the <t AUXCAPS> structure (filled
* by <f auxGetDevCaps>).
*
* @rdesc Returns zero if the function was successful. Otherwise, it returns
* an error number. Possible error returns are:
* @flag MMSYSERR_BADDEVICEID | Specified device ID is out of range.
* @flag MMSYSERR_NODRIVER | The driver failed to install.
*
* @xref auxSetVolume
****************************************************************************/
UINT WINAPI auxGetVolume(UINT wDeviceID, LPDWORD lpdwVolume)
{
V_WPOINTER(lpdwVolume, sizeof(DWORD), MMSYSERR_INVALPARAM);
return (UINT)auxOutMessage(wDeviceID, AUXDM_GETVOLUME, (DWORD)lpdwVolume, 0);
}
/*****************************************************************************
* @doc EXTERNAL AUX
*
* @api UINT | auxSetVolume | This function sets the volume in an
* auxiliary output device.
*
* @parm UINT | wDeviceID | Identifies the auxiliary output device to be
* queried. Device IDs are determined implicitly from the number of
* devices present in the system. Device ID values range from zero
* to one less than the number of devices present. Use <f auxGetNumDevs>
* to determine the number of auxiliary devices in the system.
*
* @parm DWORD | dwVolume | Specifies the new volume setting. The
* low-order word specifies the left channel volume setting, and the
* high-order word specifies 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 <p dwVolume> specifies the volume
* level, and the high-order word is ignored.
*
* @rdesc Returns zero if the function was successful. Otherwise, it returns
* an error number. Possible error returns are:
* @flag MMSYSERR_BADDEVICEID | Specified device ID is out of range.
* @flag MMSYSERR_NODRIVER | The driver failed to install.
*
* @comm Not all devices support volume control.
* To determine whether the device supports volume control, use the
* AUXCAPS_VOLUME flag to test the <e AUXCAPS.dwSupport> field of the
* <t AUXCAPS> structure (filled by <f auxGetDevCaps>).
*
* To determine whether the device supports volume control on both the
* left and right channels, use the AUXCAPS_LRVOLUME flag to test the
* <e AUXCAPS.dwSupport> field of the <t AUXCAPS> structure (filled
* by <f auxGetDevCaps>).
*
* Most devices do not support the full 16 bits of volume level control
* and will use only the high-order bits of the requested volume setting.
* For example, for a device that supports 4 bits of volume control,
* requested volume level values of 0x4000, 0x4fff, and 0x43be will
* all produce the same physical volume setting, 0x4000. The
* <f auxGetVolume> function will return the full 16-bit setting set
* with <f auxSetVolume>.
*
* Volume settings are interpreted logarithmically. This means the
* perceived volume increase is the same when increasing the
* volume level from 0x5000 to 0x6000 as it is from 0x4000 to 0x5000.
*
* @xref auxGetVolume
****************************************************************************/
UINT WINAPI auxSetVolume(UINT wDeviceID, DWORD dwVolume)
{
return (UINT)auxOutMessage(wDeviceID, AUXDM_SETVOLUME, dwVolume, 0);
}