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を返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。
リターン コード | 説明 |
---|---|
|
ハードウェアは他のデータでビジー状態です。 |
|
lpMidiOutHdr が指すバッファーが準備されていません。 |
|
指定されたデバイス ハンドルが無効です。 |
|
指定されたポインターまたは構造体が無効です。 |
解説
バッファーを midiOutLongMsg に渡す前に、 midiOutPrepareHeader 関数を使用してバッファーを準備する必要があります。 MIDI 出力デバイス ドライバは、データが同期的に送信されるか非同期的に送信されるかを決定します。
要件
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | mmeapi.h (Windows.h を含む) |
Library | Winmm.lib |
[DLL] | Winmm.dll |