Platform SDK: DirectX

IDirectSoundCaptureBuffer::GetCurrentPosition

IDirectSoundCaptureBuffer::GetCurrentPosition メソッドは、バッファ内の現在のキャプチャ位置と読み込み位置を取得する。

キャプチャ位置は、読み込み位置より前方にある。物理デバイスまたはホストがキャプチャ データをバッファリングする可能性があるので、これらの位置は常に同一になるとは限らない。読み込み位置より後でキャプチャ位置より前のデータは (キャプチャ位置を含む)、必ずしも有効なデータとは限らない。

HRESULT GetCurrentPosition(
  LPDWORD lpdwCapturePosition,  
  LPDWORD lpdwReadPosition  
);

パラメータ

lpdwCapturePosition
DirectSoundCaptureBuffer オブジェクト内の現在のキャプチャ位置を受け取る変数のアドレス。この位置は、キャプチャ バッファ内のオフセットであり、バイト単位で指定する。呼び出し側がこの位置情報に関心がない場合には、この値を NULL にできる。
lpdwReadPosition
DirectSoundCaptureBuffer オブジェクト内で、安全にデータを読み込める現在位置を受け取る変数のアドレス。この位置は、キャプチャ バッファ内のオフセットであり、バイト単位で指定する。呼び出し側がこの位置情報に関心がない場合には、この値を NULL にできる。

戻り値

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

DSERR_INVALIDPARAM
DSERR_NODRIVER
DSERR_OUTOFMEMORY

動作環境

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