midiInUnprepareHeader 関数 (mmeapi.h)

  • [アーティクル]

midiInUnprepareHeader 関数は、midiInPrepareHeader 関数によって実行される準備をクリーンアップします。

構文

MMRESULT midiInUnprepareHeader(
  HMIDIIN   hmi,
  LPMIDIHDR pmh,
  UINT      cbmh
);

パラメーター

hmi

MIDI 入力デバイスへのハンドル。

pmh

クリーンアップするバッファーを識別する MIDIHDR 構造体へのポインター。

cbmh

MIDIHDR 構造体のサイズ。

戻り値

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

リターン コード 説明
MIDIERR_STILLPLAYING
 lpMidiInHdr が指すバッファーはまだキュー内にあります。
MMSYSERR_INVALPARAM
 指定されたポインターまたは構造体が無効です。
MMSYSERR_INVALHANDLE
 指定されたデバイス ハンドルが無効です。

解説

この関数は、 midiInPrepareHeader に対して補完的です。 バッファーを解放する前に、この関数を使用する必要があります。 midiInAddBuffer 関数を使用してデバイス ドライバーにバッファーを渡した後、ドライバーがバッファーで終了するまで待ってから、midiInUnprepareHeader を使用する必要があります。 準備されていないバッファーの準備を解除しても効果はなく、関数は MMSYSERR_NOERRORを返します。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mmeapi.h (Windows.h を含む)
Library Winmm.lib
[DLL] Winmm.dll

関連項目

MIDI データ ブロックの割り当てと準備

MIDI 関数