CaptureBuffer.Start(Boolean) Method (Microsoft.DirectX.DirectSound)

  • Article

Begins capturing data into the buffer.

Definition

Visual Basic Public Sub Start( _
    ByVal looping As Boolean _
)
C# public void Start(
    bool looping
);
C++ public:
void Start(
    bool looping
);
JScript public function Start(
    looping : boolean
);

Parameters

looping System.Boolean
Set to true if, after the end of the buffer is reached, capture restarts at the beginning and continues until explicitly stopped; otherwise, false.

Remarks

If the buffer is already capturing, the method has no effect.

If the buffer is already capturing, a call to this method using a different value in looping might not change the value returned by Looping.

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 Windows Driver Model (WDM) drivers stop capturing when the thread is terminated.

Exceptions

ArgumentExceptionLeave Site

An invalid parameter was passed to the called method.

OutOfMemoryExceptionLeave Site

Microsoft DirectSound could not allocate sufficient memory to complete the call.

NoDriverException

No sound driver is available for use, or the given globally unique identifier (GUID) is not a valid DirectSound device identifier (ID).