Export (0) Print
Expand All
Expand Minimize

mixerMessage function

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

Syntax


DWORD mixerMessage(
  HMIXER driverID,
  UINT uMsg,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2
);

Parameters

driverID

Identifier of the mixer that receives the message. You must cast the device ID to the HMIXER handle type. If you supply a handle instead of a device ID, the function fails and returns the MMSYSERR_NOSUPPORT error code.

uMsg

Custom mixer driver message to send to the mixer driver. This message must be above or equal to the MXDM_USER constant.

dwParam1

Parameter associated with the message being sent.

dwParam2

Parameter associated with the message being sent.

Return value

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

Return codeDescription
MMSYSERR_INVALHANDLE

The specified device handle is invalid.

MMSYSERR_INVALPARAM

The uMsg parameter specified in the MXDM_USER message is invalid.

MMSYSERR_NOSUPPORT

The deviceID parameter must be a valid device ID.

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.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Mmsystem.h (include Windows.h)

Library

Winmm.lib

DLL

Winmm.dll

See also

Audio Mixers
Audio Mixer Functions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft