Platform SDK: DirectX

DirectSoundCaptureBuffer.ReadBuffer

The DirectSoundCaptureBuffer.ReadBuffer method reads a segment of the sound capture buffer and stores the data in an application buffer.

object.ReadBuffer(start As Long, _
    size As Long, _
    buffer As Any, _
    flags As CONST_DSCBLOCKFLAGS)

Parameters

object
Object expression that resolves to a DirectSoundCaptureBuffer object.
start
Offset, in bytes, from the start of the buffer to where the read begins.
size
Size, in bytes, of the portion of the buffer to read. The sound buffer is conceptually circular, so this value can be greater than the number of bytes between start and the end of the buffer. This parameter is ignored if the DSCBLOCK_ENTIREBUFFER constant is set in the flags argument.
buffer
Variable to hold the data read. Typically this is an array of bytes, and you pass the first element of the array.
flags
One of the constants of the CONST_DSCBLOCKFLAGS enumeration.

Error Codes

If the method fails, an error is raised and Err.Number may be set to one of the following error codes.

DSERR_BUFFERLOST
DSERR_INVALIDCALL
DSERR_INVALIDPARAM
DSERR_PRIOLEVELNEEDED