The midiOutGetDevCaps function queries a specified MIDI output device to determine its capabilities.
MMRESULT midiOutGetDevCaps(
UINT uDeviceID,
LPMIDIOUTCAPS lpMidiOutCaps,
UINT cbMidiOutCaps
);
This parameter can also be a properly cast device handle.
Returns MMSYSERR_NOERROR if successful or an error otherwise. Possible error values include the following:
Value | Description |
---|---|
MMSYSERR_BADDEVICEID | The specified device identifier is out of range. |
MMSYSERR_INVALPARAM | The specified pointer or structure is invalid. |
MMSYSERR_NODRIVER | The driver is not installed. |
MMSYSERR_NOMEM | The system is unable to load mapper string description. |
To determine the number of MIDI output devices present in the system, use the midiOutGetNumDevs function.
Windows NT: Requires version 3.1 or later.
Windows: Requires Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in mmsystem.h.
Import Library: Use winmm.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT.
Musical Instrument Digital Interface (MIDI) Overview, MIDI Functions, MIDIOUTCAPS, midiOutGetNumDevs