mixerMessage
A version of this page is also available for
4/8/2010
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 |
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
| Note | Version 2.12 requires DXPAK 1.0 or later |