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