midiOutClose

指定された MIDI 出力デバイスをクローズします。

MMRESULT midiOutClose(
    HMIDIOUT hmo  // MIDI出力デバイスのハンドル
);

WINMM.DLL

引数

hmo

MIDI 出力デバイスのハンドルを指定します。関数が成功した場合は、以後このハンドルは無効になります。

戻り値

関数が成功すると 0 (MMSYSERR_NOERROR) が返ります。

関数が失敗すると、以下のエラーが返ります。

値 意味
5 (MMSYSERR_INVALHANDLE)

指定されたハンドルは無効です。
7 (MMSYSERR_NOMEM)

メモリの確保またはロックに失敗しました。
65 (MIDIERR_STILLPLAYING)

キューの中にまだバッファが存在します。

解説

midiOutLongMsg 関数によって送られ、アプリケーションに返されていない出力バッファがある場合は、クローズ操作は失敗します。未処理のバッファを処理されたものとするには、 midiOutReset 関数を使います。

対応情報

Windows 95 以降 / Windows NT 3.1 以降