##### Sound Library - One Shotモジュールコントロール関数

# sdShotOpen

One Shotポートのアクセス権の取得

### 書式

> `SDE_ERR sdShotOpen( handle )
> SDSHOT *handle
> `

### 引数

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

### 戻り値

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

### 解説

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

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

### 備考

> アクセス権の確保・破棄を頻繁に行うとCPU負荷が大きくなります。

> できるだけハンドルを使いまわすようにしてください。 例えば、ステージの初期化時に確保して、終了時に破棄すればCPU負荷は小さく押さえられます。

> 標準ではOne Shot音源は全ポートで8 Slot確保されています.これを変更するにはsdSysSetSlotNum()関数を使用します。

### 参照

> sdShotClose() | 1つのOne Shotポートのアクセス権の放棄
> sdShotCloseAll() | 全てのOne Shotポートのアクセス権の放棄

sdShotOpen

COPYRIGHT © SEGA ENTERPRISES, LTD., 1998-2000