midiOutReset 関数 (mmeapi.h)
midiOutReset 関数は、指定された MIDI 出力デバイスのすべての MIDI チャンネルのすべてのノートをオフにします。
構文
MMRESULT midiOutReset(
HMIDIOUT hmo
);
パラメーター
hmo
MIDI 出力デバイスにハンドルします。 このパラメーターは、 HMIDIOUT にキャストされた MIDI ストリームのハンドルにすることもできます。
戻り値
成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
指定されたデバイス ハンドルが無効です。 |
解説
保留中のシステム排他またはストリーム出力バッファーはすべてコールバック関数に返され、MHDR_DONE フラグは MIDIHDR 構造体の dwFlags メンバーに設定されます。
EOX (排他終了) バイトを送信せずにシステム排他メッセージを終了すると、受信側デバイスに問題が発生する可能性があります。 midiOutReset 関数は、システム排他メッセージを終了するときに EOX バイトを送信しません。アプリケーションはこれを行う必要があります。
すべてのノートをオフにするには、各チャネルの各ノートのノートオフ メッセージが送信されます。 さらに、チャンネルごとにサステインコントローラーがオフになっています。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mmeapi.h (Windows.h を含む) |
| Library | Winmm.lib |
| [DLL] | Winmm.dll |