Microsoft DirectX 9.0

IDirectSoundCaptureBuffer8::Start

The Start method begins capturing data into the buffer. If the buffer is already capturing, the method has no effect.

Syntax

HRESULT Start(
  DWORD dwFlags 
);

Parameters

dwFlags

Flags that specify the behavior of the buffer when capturing sound data. The following flag is defined:

Value Description
DSCBSTART_LOOPING After the end of the buffer is reached, capture restarts at the beginning and continues until explicitly stopped.

Remarks

If the buffer is already capturing, a call to this method using a different value in dwFlags might not change the value returned by IDirectSoundCaptureBuffer8::GetStatus.

If the application is multithreaded, the thread that starts the buffer must continue to exist as long as the buffer is capturing. Buffers created on WDM drivers stop capturing when the thread is terminated.

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