midiOutLongMsg 関数 (mmeapi.h)

  • [アーティクル]

midiOutLongMsg 関数は、指定された MIDI 出力デバイスにシステム排他 MIDI メッセージを送信します。

構文

MMRESULT midiOutLongMsg(
  HMIDIOUT  hmo,
  LPMIDIHDR pmh,
  UINT      cbmh
);

パラメーター

hmo

MIDI 出力デバイスへのハンドル。 このパラメーターは、 HMIDIOUT にキャストされた MIDI ストリームのハンドルにすることもできます。

pmh

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

cbmh

MIDIHDR 構造体のサイズ (バイト単位)。

戻り値

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

リターン コード 説明
MIDIERR_NOTREADY
 ハードウェアは他のデータでビジー状態です。
MIDIERR_UNPREPARED
 lpMidiOutHdr が指すバッファーが準備されていません。
MMSYSERR_INVALHANDLE
 指定されたデバイス ハンドルが無効です。
MMSYSERR_INVALPARAM
 指定されたポインターまたは構造体が無効です。

解説

バッファーを midiOutLongMsg に渡す前に、 midiOutPrepareHeader 関数を使用してバッファーを準備する必要があります。 MIDI 出力デバイス ドライバは、データが同期的に送信されるか非同期的に送信されるかを決定します。

要件

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

関連項目

MIDI 関数