Microsoft DirectX 8.0 (Visual Basic)

DirectSoundSecondaryBuffer8

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    

See Also

DirectSoundPrimaryBuffer8, DirectSound Buffers