Platform SDK: DirectX

IDirectSoundBuffer::SetCurrentPosition

IDirectSoundBuffer::SetCurrentPosition メソッドは、セカンダリ サウンド バッファのカレント プレイ ポジションを移動する。

HRESULT SetCurrentPosition(
  DWORD dwNewPosition  
);

パラメータ

dwNewPosition
サウンド バッファの再生に使われる新しい位置。バッファの先頭からのオフセット値で指定する。単位はバイト。

戻り値

成功すれば DS_OK、失敗すれば次のエラー値のいずれかを返す。

DSERR_INVALIDCALL
DSERR_INVALIDPARAM
DSERR_PRIOLEVELNEEDED

注意

プライマリ サウンド バッファに対しては、このメソッドを呼び出せない。

バッファが再生中のときにこのメソッドを呼び出すと、即座に新規の位置へ移動して再生を続行する。バッファが停止している場合は、次に IDirectSoundBuffer::Play メソッドを呼び出したときに、新しい位置から再生を開始する。

動作環境

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

参照

IDirectSoundBufferIDirectSoundBuffer::GetCurrentPositionIDirectSoundBuffer::Play