Capturing a sound consists of the following steps:

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

   To make sure you are not attempting to lock a portion of memory that is about to be used for capture, you can 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 Lockmethod, 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 Lockmethod.
5. Unlock the buffer with the IDirectSoundCaptureBuffer::Unlockmethod.
6. Repeat steps 2 to 5 until you are ready to stop capturing data. Then call the IDirectSoundCaptureBuffer::Stopmethod.

   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 dwFlagsparameter to the IDirectSoundCaptureBuffer::Startmethod, the capture will continue until the application calls the IDirectSoundCaptureBuffer::Stopmethod.

   
   

   ---

    Last updated on Tuesday, May 18, 2004

   © 2004 Microsoft Corporation. All rights reserved.