Microsoft DirectX 8.0 (Visual Basic) |
An object of the DirectSoundSecondaryBuffer8 class represents a secondary play buffer. Sounds from secondary buffers are mixed into the primary buffer.
The object can be obtained by using the DirectSound8.CreateSoundBuffer, DirectSound8.CreateSoundBufferFromFile, or DirectSound8.CreateSoundBufferFromResource method. In applications that use audiopaths, a secondary buffer can be retrieved by using the DirectMusicAudioPath8.GetObjectInPath method.
The DirectSoundSecondaryBuffer8 methods can be organized into the following groups.
Effects | SetFX |
Information | GetCaps |
GetFormat | |
GetStatus | |
Memory management | AcquireResources |
Restore | |
Miscellaneous | GetObjectInPath |
SaveToFile | |
Obtaining objects | GetDirectSound3DBuffer |
Play management | GetCurrentPosition |
Play | |
ReadBuffer | |
SetCurrentPosition | |
SetNotificationPositions | |
Stop | |
WriteBuffer | |
Sound management | GetFrequency |
GetPan | |
GetVolume | |
SetFrequency | |
SetPan | |
SetVolume |
The following table shows which methods are supported for buffer objects obtained from an audiopath; that is, buffers created by a DirectMusic performance. Mix-in buffers accept sends from other buffers. All other buffers in the audiopath are sink-in buffers, which means that they accept data only from the synthesizer sink.
DirectSoundSecondaryBuffer8 method | Mix-in | Sink-in |
---|---|---|
AcquireResources | ||
GetCaps | Yes | Yes |
GetCurrentPosition | ||
GetDirectSound3D Buffer | Yes | Yes |
GetFormat | Yes | Yes |
GetFrequency | ||
GetObjectInPath | Yes | Yes |
GetPan | Yes | Yes |
GetStatus | Yes | Yes |
GetVolume | Yes | Yes |
Play | Yes | |
ReadBuffer | ||
Restore | ||
SaveToFile | ||
SetCurrentPosition | ||
SetFrequency | ||
SetFX | Yes | Yes |
SetNotificationPositions | ||
SetPan | Yes | Yes |
SetVolume | Yes | Yes |
Stop | Yes | |
WriteBuffer |