Platform SDK: DirectX

IDirectSoundBuffer::GetStatus

IDirectSoundBuffer::GetStatus メソッドは、サウンド バッファの現在のステータスを取得する。

HRESULT GetStatus(
  LPDWORD lpdwStatus  
);

パラメータ

lpdwStatus
サウンド バッファのステータスを保持する変数のアドレス。ステータスは、以下のフラグの組み合わせである。
DSBSTATUS_BUFFERLOST
バッファは失われており、再生やロックを行う前に復元しなければならない。
DSBSTATUS_LOOPING
バッファはループしている。この値が設定されていない場合、バッファのサウンド データの最後に達すると再生は停止する。この値が設定されているとき、バッファは必ず再生されている点に注意すること。
DSBSTATUS_PLAYING
バッファは再生中である。この値が設定されていない場合、バッファは停止している。
DSBSTATUS_LOCSOFTWARE
ソフトウェアのバッファは再生中である。DSBCAPS_LOCDEFER フラグで作成したバッファにだけ設定する。
DSBSTATUS_LOCHARDWARE
ハードウェアのバッファは再生中である。DSBCAPS_LOCDEFER フラグで作成したバッファにだけ設定する。
DSBSTATUS_TERMINATED
ボイス管理がバッファを早めに終了し、バッファは停止している。DSBCAPS_LOCDEFER フラグで作成したバッファにだけ設定する。

戻り値

成功すれば DS_OK、失敗すれば DSERR_INVALIDPARAM を返す。

動作環境

  Windows NT/2000 : Service Pack 3 を適用した Windows NT バージョン 4.0 以降が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dsound.h で宣言。
  インポート ライブラリ : dsound.lib を使用。

参照

IDirectSoundBuffer