Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function queries a specified mixer device to determine its capabilities.

Syntax 

MMRESULT mixerGetDevCaps(
  UINT 
uMxId, 
  LPMIXERCAPS 
pmxcaps, 
  UINT 
cbmxcaps 
);

Parameters

uMxId

Identifier or handle of an open mixer device.

pmxcaps

Pointer to a MIXERCAPSstructure that receives information about the capabilities of the device.

cbmxcaps

Size, in bytes, of the MIXERCAPSstructure.

Return Value

Returns MMSYSERR_NOERROR if successful or an error otherwise.

The following table shows the possible error values.

Value Description

MMSYSERR_BADDEVICEID

The specified device identifier is out of range.

MMSYSERR_INVALHANDLE

The mixer device handle is invalid.

MMSYSERR_INVALPARAM

One or more parameters are invalid.

Remarks

Use the mixerGetNumDevsfunction to determine the number of mixer devices present in the system. The device identifier specified by uMxIdvaries from zero to one less than the number of mixer devices present.

Only the number of bytes (or less) of information specified in cbmxcapsis copied to the location pointed to by pmxcaps.

If cbmxcapsis zero, nothing is copied, and the function returns successfully.

This function also accepts a mixer device handle returned by the mixerOpenfunction as the uMxIdparameter.

The application should cast the HMIXERhandle to a UINT.

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

See Also