##### 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