Microsoft DirectX 9.0

IDirectSoundCaptureBuffer8::GetCurrentPosition

The GetCurrentPosition method retrieves the positions of the capture and read cursors in the buffer.

The capture cursor is ahead of the read cursor. The data after the read position up to and including the capture position is not necessarily valid data.

Syntax

HRESULT GetCurrentPosition(
  LPDWORD pdwCapturePosition, 
  LPDWORD pdwReadPosition 
);

Parameters

pdwCapturePosition

Address of a variable that receives the offset from the start of the buffer, in bytes, of the capture cursor. The parameter can be NULL if this value is not wanted.

pdwReadPosition

Address of a variable that receives the offset from the start of the buffer, in bytes, of the read cursor.

Return Values

If the method succeeds, the return value is DS_OK.

If the method fails, the return value may be one of the following error values:

Return code
DSERR_INVALIDPARAM
DSERR_NODRIVER
DSERR_OUTOFMEMORY

Requirements

  Header: Declared in dsound.h.

See Also