次の方法で共有


midiInGetErrorTextA 関数 (mmeapi.h)

midiInGetErrorText 関数は、指定されたエラー コードによって識別されたエラーのテキスト説明を取得します。

構文

MMRESULT midiInGetErrorTextA(
  MMRESULT mmrError,
  LPSTR    pszText,
  UINT     cchText
);

パラメーター

mmrError

エラー コード。

pszText

テキスト エラーの説明が入力されるバッファーへのポインター。

cchText

lpTextが指すバッファーの長さ (文字数)。

戻り値

成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。

リターン コード 形容
MMSYSERR_BADERRNUM
指定したエラー番号が範囲外です。
MMSYSERR_INVALPARAM
指定されたポインターまたは構造体が無効です。
MMSYSERR_NOMEM
システムがメモリの割り当てまたはロックを行うことができません。

備考

テキスト エラーの説明が指定されたバッファーより長い場合、説明は切り捨てられます。 返されるエラー文字列は常に null で終了します。 cchText 0 の場合、何もコピーされません。関数は 0 を返します。 すべてのエラー記述が MAXERRORLENGTH 文字未満です。

手記

mmeapi.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして midiInGetErrorText を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー mmeapi.h (Windows.h を含む)
ライブラリ Winmm.lib
DLL Winmm.dll

関連項目

MIDI Functions