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:
|
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.
See Also