IDirectSoundCaptureBuffer8::Start

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

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.

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

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 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.

Requirements

Header: Declared in Dsound.h.

Import Library: Use Dsound3d.dll.

See Also

IDirectSoundCaptureBuffer8