Sound Library - システム関数

sdSysGetUsedHostCmd

Sound LibraryのHost Command Bufferの使用量の取得

書式

SDE_ERR sdSysGetUsedHostCmd( percent )
Sint32 *percent

引数

percent   ホストコマンドの現在使用量(%)を格納する変数へのポインタ

戻り値

SDE_ERR_NOTHING   エラーなし
SDE_ERR_NO_INIT   Sound Library が初期化されていない
SDE_ERR_PTR_NULL   modeがNULL Address

解説

現在Host Commandをどの程度使用しているのかを返します。

引数 percent に返す値の単位は%で、範囲は0〜100です。


備考

サウンドライブラリ側のキューバッファ256個分を検索し、どの程度使用しているのかを返します。

ホストコマンドは1V-intで32個分送信されますので、通常は256個全て送信するのに8V-int必要です。

また、ホストコマンドバッファが溢れてしまった場合、溢れた分は捨てられてしまいますので正常な動作を保証できなくなってしまいます。 この関数でチェックを行い、溢れる事の無いよう管理してください。


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