mixerMessage

The mixerMessage function sends a custom mixer driver message directly to a mixer driver.

DWORD mixerMessage(
  HMIXER hmx,     
  UINT uMsg,      
  DWORD dwParam1, 
  DWORD dwParam2  
);

Parameters

hmx
Handle of an open instance of a mixer device. This handle is returned by the mixerOpen function.
uMsg
Custom mixer driver message to send to the mixer driver. This message must be above or equal to the MXDM_USER constant.
dwParam1 and dwParam2
Arguments associated with the message being sent.

Return Values

Returns a value that is specific to the custom mixer driver message. Possible error values include the following:

Value Description
MMSYSERR_INVALHANDLE The specified device handle is invalid.
MMSYSERR_INVALPARAM The uMsg parameter specified in the MXDM_USER message is invalid.
MMSYSERR_NOTSUPPORTED The mixer device did not process the message.

Remarks

User-defined messages must be sent only to a mixer driver that supports the messages. The application should verify that the mixer driver is the driver that supports the message by retrieving the mixer capabilities and checking the wMid, wPid, vDriverVersion, and szPname members of the MIXERCAPS structure.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in mmsystem.h.
  Import Library: Use winmm.lib.

See Also

Audio Mixers Overview, Audio Mixer Functions, mixerOpen, MIXERCAPS