Microsoft DirectX 8.0 (C++)

IDirectSoundBuffer8::GetStatus

サウンド バッファのステータスを取得する。

HRESULT GetStatus(
  LPDWORD pdwStatus 
);

パラメータ

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

戻り値

成功した場合は DS_OK を返す。

失敗した場合は DSERR_INVALIDPARAM を返す。

動作環境

  ヘッダー : dsound.h で宣言。