Share via

mixerMessage (Compact 2013)

  • Article

3/26/2014

This function sends a custom mixer driver message directly to a mixer driver.

Syntax

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

Parameters

  • hmx
    Handle to 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
    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.

The following table shows the possible values.

Value

Description

MMSYSERR_INVALHANDLE

The specified device handle is invalid.

MMSYSERR_INVALPARAM

The uMsg parameter 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.

Requirements

Header

mmsystem.h

Library

coredll.lib

See Also

Reference

Hardware Audio Mixer Functions
mixerOpen
MIXERCAPS