waveOutGetErrorText

  MMRESULT waveOutGetErrorText(wError, lpText, wSize)    
  UINT wError;    
  LPSTR lpText;    
  UINT wSize;    

The waveOutGetErrorText function retrieves a textual description of the error identified by the specified error number.

Parameters

wError

Specifies the error number.

lpText

Specifies a far pointer to a buffer to be filled with the textual error description.

wSize

Specifies the size of the buffer.

Return Value

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

Value Meaning

MMSYSERR_BADERRNUM Specified error number is out of range.

Comments

If the textual error description is longer than the specified buffer,the description is truncated. The returned error string is always null-terminated. If wSize is zero, nothing is copied, and the function returns zero. All error descriptions are less than MAXERRORLENGTH characters long.