waveOutGetDevCaps function

The waveOutGetDevCaps function retrieves the capabilities of a given waveform-audio output device.

Syntax

MMRESULT waveOutGetDevCaps(
   UINT_PTR      uDeviceID,
   LPWAVEOUTCAPS pwoc,
   UINT          cbwoc
);

Parameters

• uDeviceID
  Identifier of the waveform-audio output device. It can be either a device identifier or a handle of an open waveform-audio output device.

• pwoc
  Pointer to a WAVEOUTCAPS structure to be filled with information about the capabilities of the device.

• cbwoc
  Size, in bytes, of the WAVEOUTCAPS structure.

Return value

Returns MMSYSERR_NOERROR if successful or an error otherwise. Possible error values include the following.

Remarks

Use the waveOutGetNumDevs function to determine the number of waveform-audio output devices present in the system. If the value specified by the uDeviceID parameter is a device identifier, it can vary from zero to one less than the number of devices present. The WAVE_MAPPER constant can also be used as a device identifier. Only cbwoc bytes (or less) of information is copied to the ___location pointed to by pwoc. If cbwoc is zero, nothing is copied and the function returns zero.

Requirements

See also

Waveform Audio

Waveform Functions