Capturing Sounds

Capturing a sound consists of the following steps:

1. Start the buffer by calling the IDirectSoundCaptureBuffer::Start method. Audio data from the input device begins filling the buffer from the beginning.
2. Wait until the desired amount of data is available. See Capture Buffer Notification for one method of determining when the capture position reaches a certain point.
3. When sufficient data is available, lock a portion of the capture buffer by calling the IDirectSoundCaptureBuffer::Lock method.

   To make sure you are not attempting to lock a portion of memory that is about to be used for capture, you should first obtain the current read position by calling IDirectSoundCaptureBuffer::GetCurrentPosition. For an explanation of the read position, see Capture Buffer Information.

   As parameters to the Lock method, you pass the size and offset of the block of memory you want to read. The method returns a pointer to the address where the memory block begins, and the size of the block. If the block wraps around from the end of the buffer to the beginning, two pointers are returned, one for each section of the block. The second pointer is NULL if the locked portion of the buffer does not wrap around.

4. Copy the data from the buffer, using the addresses and block sizes returned by the Lock method.
5. Unlock the buffer with the IDirectSoundCaptureBuffer::Unlock method.
6. Repeat steps 2 to 5 until all the data is captured. Then call the IDirectSoundCaptureBuffer::Stop method.

Normally the buffer stops capturing automatically when the capture position reaches the end of the buffer. However, if the DSCBSTART_LOOPING flag was set in the dwFlags parameter to the IDirectSoundCaptureBuffer::Start method, the capture will continue until the application calls the IDirectSoundCaptureBuffer::Stop method, at which point the capture position is moved to the beginning of the buffer.