midiOutGetDevCaps

  MMRESULT midiOutGetDevCaps(wDeviceID, lpCaps, wSize)    
  UINT wDeviceID;    
  LPMIDIOUTCAPS lpCaps;    
  UINT wSize;    

The midiOutGetDevCaps function queries a specified MIDI output device to determine its capabilities.

Parameters

wDeviceID

Identifies the MIDI output device.

lpCaps

Specifies a far pointer to a MIDIOUTCAPS structure. This structure is filled with information about the capabilities of the device.

wSize

Specifies the size of the MIDIOUTCAPS structure.

Return Value

Returns zero if the function was successful. Otherwise, it returns an error number. Possible error returns are:

Value Meaning

MMSYSERR_BADDEVICEID Specified device ID is out of range.
MMSYSERR_NODRIVER The driver was not installed.
MMSYSERR_NOMEM Unable load mapper string description.

Comments

Use midiOutGetNumDevs to determine the number of MIDI output devices present in the system. The device ID specified by wDeviceID varies from zero to one less than the number of devices present. The MIDI_MAPPER constant may also be used as a device id. Only wSize bytes (or less) of information is copied to the location pointed to by lpCaps. If wSize is zero, nothing is copied,and the function returns zero.

See Also

midiOutGetNumDevs