Atom D-BAS ID.

説明:

criAtomDbas_Create 関数に失敗した際に返る値です。

参照:

criAtomDbas_Create, criAtomDbas_Destroy

D-BAS作成用のデフォルトのバッファ保証数

説明:

D-BAS作成用のデフォルトのバッファ保証数です。 ループ先頭、およびループ終端で極端にデータが少なくなる音声データであっても 途切れないようにストリーミング再生可能な安全な値を設定しています。

参照:

criAtomDbas_Create, criAtomDbas_CalculateWorkSize

D-BAS作成時に指定可能なバッファ保証数の下限値

説明:

D-BAS作成時に指定可能なバッファ保証数の下限値です。 途切れずにストリーミング再生するためには、 最低でも2バッファ（ダブルバッファリング）必要なため、 2未満の値に設定する事はできません。

参照:

criAtomDbas_Create, criAtomDbas_CalculateWorkSize

{\
    (p_config)->identifier  = 0;\
    (p_config)->max_streams = CRIATOM_DEFAULT_DBAS_MAX_STREAMS;\
    (p_config)->max_bps     = CRIATOM_DEFAULT_DBAS_MAX_BPS;\
    (p_config)->max_mana_streams    = 0;\
    (p_config)->max_mana_bps        = 0;\
    (p_config)->num_securement_buffers = CRIATOMDBAS_DEFAULT_NUM_SECUREMENT_BUFFERS;\
}

CriAtomDbasConfig へのデフォルトパラメータのセット

引数:

[out]

p_config

D-BAS作成用コンフィグ構造体へのポインタ

説明:

criAtomDbas_Create 関数に設定するコンフィグ構造体 （ CriAtomDbasConfig ）に、デフォルトの値をセットします。

参照:

CriAtomDbasConfig, criAtomDbas_Create, criAtomDbas_CalculateWorkSize

Atom D-BAS ID.

説明:

CriAtomDbasId は、D-BAS管理用のIDです。
criAtomDbas_Create 関数でD-BASを作成すると取得できます。
アプリケーションがこのD-BAS IDを利用するのは、D-BASの破棄時のみです。

参照:

criAtomDbas_Create, criAtomDbas_Destroy

D-BAS作成パラメータ構造体

説明:

criAtomDbas_Create 関数の引数に指定する、D-BASの作成パラメータ構造体です。

注意:

将来的にメンバが増える可能性があるため、 criAtomDbas_SetDefaultConfig マクロを使用しない場合には、使用前に必ず構造体をゼロクリアしてください。
（構造体のメンバに不定値が入らないようご注意ください。）

参照:

criAtomDbas_Create, criAtomDbas_CalculateWorkSize, criAtomDbas_SetDefaultConfig

D-BAS作成用ワークサイズの計算

引数:

[in]

config

D-BAS作成用コンフィグ構造体へのポインタ

戻り値:

CriSint32 D-BAS作成用ワークサイズ

戻り値:

0以上	正常に処理が完了
-1	エラーが発生

説明:

D-BAS作成用パラメータに基づいて、D-BASの作成に必要ワークサイズを計算します。

ワーク領域サイズの計算に失敗すると、本関数は -1 を返します。
ワーク領域サイズの計算に失敗した理由については、エラーコールバックのメッセージで確認可能です。

注意:

本関数を実行する前に、ライブラリを初期化しておく必要があります。

設定によっては、D-BASが2GB以上のワークサイズを必要とする場合があり、
その際はエラーになり、 -1 を返します。
エラーが発生した場合は、max_streamsかmax_bpsの値を低く設定してください。

参照:

criAtomDbas_Create

D-BASの作成

引数:

[in]	config	D-BAS作成用コンフィグ構造体へのポインタ
[in]	work	D-BAS作成用ワーク領域へのポインタ
[in]	work_size	D-BAS作成用ワークサイズ

戻り値:

CriAtomDbasId D-BAS管理用ID

説明:

D-BAS作成用パラメータに基づいて、D-BASを作成します。
作成に成功すると、D-BASをライブラリに登録し、有効な管理用IDを返します。
D-BASの作成に失敗した場合、本関数は CRIATOMDBAS_ILLEGAL_ID を返します。
（エラーの原因はエラーコールバックに返されます。）

取得したIDは::criAtomDbas_Destroy 関数で使用します。

注意:

本関数を実行する前に、ライブラリを初期化しておく必要があります。

参照:

criAtomDbas_CalculateWorkSize, criAtomDbas_Destroy

D-BASの破棄

引数:

[in]

atom_dbas_id

D-BAS管理用ID

説明:

criAtomDbas_Create 関数で取得した管理用IDを指定して、D-BASを破棄します。

参照:

criAtomDbas_Create

ストリーム再生中のAtomプレーヤハンドルを取得

引数:

[in]	dbas_id	D-BAS管理用ID
[out]	players	プレーヤハンドル受け取り用配列
[in]	length	プレーヤハンドル受け取り用配列要素数

戻り値:

CriSint32 プレーヤ数

戻り値:

0以上	正常に処理が完了
-1	エラーが発生

説明:

ストリーム再生中のAtomプレーヤハンドルを取得します。
プレーヤハンドルの取得に成功すると、 第3引数（players配列）にプレーヤハンドルのアドレスが保存され、 プレーヤハンドル数が戻り値として返されます。

備考:

第3引数（players配列）にNULL、第4引数（length）に0を指定することで、 ストリーム再生中のプレーヤの数だけを戻り値として取得可能です。

注意:

プレーヤ数を取得してからハンドルを取得する場合、 プレーヤ数取得とハンドル取得の間にサーバ処理が割り込まないよう、 criAtom_Lock 関数で排他制御を行う必要があります。
（サーバ処理のタイミングで、プレーヤ数が変わる可能性があります。）

配列要素数がストリーム再生中のプレーヤ数に満たない場合、 本関数はエラー値（-1）を返します。