 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
The IDsDriverBufferinterface is used to manipulate individual sound buffers, which are separate objects from the main driver object (which supports IDsDriver). The IDsDriver::CreateSoundBuffermethod creates a sound buffer object and returns an IDsDriverBufferinterface. A DirectSound driver is only required to implement sound buffer objects for hardware sound buffers (that is, the primary streaming sound buffer, and sound buffers located in onboard memory). DirectSound takes care of implementing software buffers.
The IDsDriverBufferinterface contains the following methods:
| IUnknown Methods | Description |
|---|---|
| AddRef | Increments the reference count. |
| QueryInterface | Retrieves pointers to supported interfaces. |
| Release | Decrements the reference count. |
| IDsDriverBuffer Methods | |
| GetPosition | Called to query the current position of the buffer. |
| GetStatus | Retrieves the current state of the buffer. |
| Lock | Retrieves a valid write pointer into the buffer. |
| Play | Causes the buffer to start playing from the current position. |
| SetFormat | Sets the format of the primary sound buffer. |
| SetFrequency | Sets the frequency at which audio samples are to be played. |
| SetPosition | Changes the current position of the play cursor. |
| SetVolumePan | Sets the volume of playback. |
| Stop | Stops playback of the buffer. |
| Unlock | Releases a block of data to the driver. |
Last updated on Tuesday, July 13, 2004