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 で宣言。