<Return[WXYZ]><Top>

waveInGetErrorText

Declare Function Api_waveInGetErrorText& Lib "winmm" Alias "waveInGetErrorTextA" (ByVal mmrError&, ByVal pszText$, ByVal cchText&)

Declare Function waveInGetErrorText Lib "winmm" Alias "waveInGetErrorTextA" (ByVal mmrError As Long, ByVal pszText As String, ByVal cchText As Long) As Long

提供されたエラー番号で識別される、エラーの原文記述を取得する。

パラメータ
mmrError
    エラー番号を指定する。
pszText
    エラーの原文記述が入るバッファのアドレスを指定する。
cchText
    pszText パラメータが指すバッファのサイズを文字数で指定する。

戻り値
    関数が成功すると、MMSYSERR_NOERROR が返る。関数が失敗すると、エラーが返る。返されるエラー値は次のとおりである。

    値                                             

説明                                                                                                                        

    MMSYSERR_BADERRNUM

指定されたエラー番号は範囲外である。

    MMSYSERR_NODRIVER

デバイスドライバが存在しない。

    MMSYSERR_NOMEM

メモリを割り当てられないか、またはロックできない。


解説
    エラーの原文記述が指定されたバッファの長さを超える場合、その記述は切り捨てられる。返されるエラー文字列は、常に NULL で終わ

    る。cchText パラメータが 0 の場合は何もコピーされず、関数は 0 を返す。エラー原文記述の文字数は、すべて MAXERRORLENGTH

    未満である。