| Microsoft DirectX 8.1 (C++) |
The IDirectSoundCaptureBuffer8 interface is used to manipulate sound capture buffers.
To obtain the IDirectSoundCaptureBuffer8 interface, call the IDirectSoundCapture8::CreateCaptureBuffer method to obtain IDirectSoundCaptureBuffer, then pass IID_IDirectSoundCaptureBuffer8 to IDirectSoundCaptureBuffer::QueryInterface.
Note IDirectSoundCaptureBuffer8 cannot be obtained if the IDirectSoundCapture8 interface was obtained by using the DirectSoundCaptureCreate function. See DirectSoundCaptureCreate8.
In addition to the methods inherited from IUnknown, the IDirectSoundCaptureBuffer8 interface exposes the following methods.
| Method | Description |
| Lock | Locks a portion of the buffer, allowing the application to read or write audio data. |
| Start | Begins capturing data into the buffer. |
| Stop | Stops the buffer so that it is no longer capturing data. |
| Unlock | Unlocks the buffer. |
| Method | Description |
| GetFXStatus | Retrieves the status of capture effects. |
| GetObjectInPath | Retrieves an interface to an effect object associated with the buffer. |
| Method | Description |
| Initialize | Initializes a capture buffer object. Not used by applications. |
| Method | Description |
| GetCaps | Retrieves the capabilities of the buffer. |
| GetCurrentPosition | Retrieves the capture and read cursors in the buffer. |
| GetFormat | Retrieves the format of the capture buffer. |
| GetStatus | Retrieves the status of the capture buffer. |
The LPDIRECTSOUNDCAPTUREBUFFER8 type is defined as a pointer to the IDirectSoundCaptureBuffer8 interface:
typedef struct IDirectSoundCaptureBuffer8 *LPDIRECTSOUNDCAPTUREBUFFER8;
Requirements
Header: Declared in dsound.h.