Sound Library - MIDIモジュールコントロール関数

sdMidiOpen

MIDIポートのアクセス権の取得

書式

SDE_ERR sdMidiOpen( handle )
SDMIDI *handle

引数

handle   ポートのハンドルを格納する変数のポインタ

戻り値

SDE_ERR_NOTHING   エラーなし
SDE_ERR_NO_INIT   Sound Library が初期化されていない
SDE_ERR_HANDLE_NO_ENOUGH   ハンドルを取得できない

解説

MIDIポートのアクセス権を取得します。

戻り値がSDE_ERR_HANDLE_NO_ENOUGHの場合は音源の発音数が足りなかったか、取得できるハンドルをすべて使いきったかのどちらかを意味します。


備考

アクセス権の確保・破棄を頻繁に行うとCPU負荷が大きくなります。 できるだけハンドルを使いまわすようにしてください。 例えば、ステージの初期化時に確保して、終了時に破棄すればCPU負荷は小さく押さえられます。 標準ではMIDI音源は全ポートで48 Slot確保されています.これを変更するにはsdSysSetSlotNum()関数を使用します。

参照

sdMidiClose()
 1つのMIDIポートのアクセス権の放棄
sdMidiCloseAll()
 全てのMIDIポートのアクセス権の放棄

sdMidiOpen
COPYRIGHT © SEGA ENTERPRISES, LTD., 1998-2000