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►
────────────────────────────────────────────────────────────────────────────
MODM_GETVOLUME
 
        This message is sent to a MIDI 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
        Only drivers for internal synthesizer devices can support volume
        level changes. Drivers for MIDI output ports should return a
        MMSYSERR_NOTSUPPORTED error for this message. Support for volume
        level changes by internal synthesizer devices is optional.
        However, if a driver supports changes to the volume level with
        the MODM_SETVOLUME message, it must support queries with the
        MODM_GETVOLUME message.
 
See also
        MODM_SETVOLUME
 
                                       -♦-