Sound Library - メモリコントロール関数

sdSndMemBlockGetMap

サウンドメモリ上のブロックのマッピング情報の取得

書式

SDE_ERR sdSndMemBlockGetMap( block_type, block_num, adr, sz )
const SDE_DATA_TYPE block_type
const Sint8 block_num
Sint32 *adr
Sint32 *sz

引数

block_type   Blockのタイプ
block_num   Blockの番号
adr   Blockの開始アドレスを取得する変数のポインタ
sz   Blockのサイズを取得する変数のポインタ

戻り値

SDE_ERR_NOTHING   エラーなし
SDE_ERR_NO_INIT   Sound Library が初期化されていない
SDE_ERR_BANK_ILLEGAL_TYPE   Block タイプが不正

解説

サウンドメモリ上のブロック情報を取得します。

Blockの種類を指定する引数 block_type には次の指定が可能です。

 定義   意味 
 SDE_DATA_TYPE_MIDI_DRUM_BANK   MIDI Drum Bank 
 SDE_DATA_TYPE_MIDI_SEQ_BANK   MIDI Sequence Bank 
 SDE_DATA_TYPE_MIDI_PRG_BANK   MIDI Program Bank 
 SDE_DATA_TYPE_SHOT_BANK   One Shot Bank 
 SDE_DATA_TYPE_PSTM_RING_BUF   PCM Stream Ring Buffer 
 SDE_DATA_TYPE_FX_OUT_BANK   FX Output Bank 
 SDE_DATA_TYPE_FX_PRG_BANK   FX Program Bank 
 SDE_DATA_TYPE_FX_PRG_WRK   FX Program Work 

block_numはblock_typeによって値の範囲が異なります。

 定義   意味 
 SDE_DATA_TYPE_MIDI_DRUM_BANK   0〜1 
 SDE_DATA_TYPE_MIDI_SEQ_BANK   0〜15 
 SDE_DATA_TYPE_MIDI_PRG_BANK   0〜15 
 SDE_DATA_TYPE_SHOT_BANK   One 0〜15 
 SDE_DATA_TYPE_PSTM_RING_BUF   0〜15 
 SDE_DATA_TYPE_FX_OUT_BANK   0 
 SDE_DATA_TYPE_FX_PRG_BANK   0 
 SDE_DATA_TYPE_FX_PRG_WRK   0 


用例

Sint32 adr;
Sint32 sz;

/*  Get address and size from PCM Stream Ring Buffer #00  */
sdSndMemBlockGetMap( SDE_DATA_TYPE_PSTM_RING_BUF, 0, &adr, &sz);

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