waveInGetErrorText

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

The waveInGetErrorText 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 the buffer to be filled with the textual error description.

wSize

Specifies the size of the buffer pointed to by lpText.

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.