Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                 ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
WODM_GETVOLUME
 
        This message is sent to a waveform output device driver to
        request the current volume level setting for a device.
 
Parameters
        DWORD dwParam1
            Specifies a far pointer to a DWORD location. The driver
            fills this location with the current volume level setting.
            The high-order word contains the right channel setting and
            the low-order word contains the left channel setting. A
            value of 0 is silence, and a value of 0xFFFF is full volume.
             If the driver does not support both left and right channel
            volume changes, it returns the volume in the low-order word.
 
        DWORD dwParam2
            Unused.
 
Return value
        The return value is an error code, or zero (MMSYSERR_NOERROR) if
        the operation is successful. Possible error codes are:
 
        MMSYSERR_NOTENABLED
            The driver failed to load or initialize.
 
        MMSYSERR_NOTSUPPORTED
            The driver does not support changes to volume level.
 
Comments
        Drivers do not have to support volume level changes. However,
        if a driver supports changes to the volume level with the
        WODM_SETVOLUME message, it must support queries with the
        WODM_GETVOLUME message.
 
See also
        WODM_SETVOLUME
 
                                       -♦-