Microsoft DirectX 9.0

IDirectSoundCaptureBuffer8 Interface

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, arranged by category.

Capture management

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.

Effects

Method Description
GetFXStatus Retrieves the status of capture effects.
GetObjectInPath Retrieves an interface to an effect object associated with the buffer.

Initialization

Method Description
Initialize Initializes a capture buffer object. Not used by applications.

Information

Method Description
GetCaps Retrieves the capabilities of the buffer.
GetCurrentPosition Retrieves the positions of the capture and read cursors in the buffer.
GetFormat Retrieves the waveform 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.

See Also