CONST_DSBPLAYFLAGS

The CONST_DSBPLAYFLAGS enumeration is used in the flags parameter of the DirectSoundSecondaryBuffer8.Play method to specify how to play the buffer.

Syntax

Enum CONST_DSBPLAYFLAGS
  DSBPLAY_DEFAULT              =  0 
  DSBPLAY_LOCHARDWARE          =  2 
  DSBPLAY_LOCSOFTWARE          =  4 
  DSBPLAY_LOOPING              =  1 
  DSBPLAY_TERMINATEBY_DISTANCE = 16 (&H10)
  DSBPLAY_TERMINATEBY_PRIORITY = 32 (&H20)
  DSBPLAY_TERMINATEBY_TIME     =  8 
End Enum

Constants

DSBPLAY_DEFAULT

Play from the play cursor to the end of the audio buffer.

DSBPLAY_LOCHARDWARE

Play this voice in a hardware buffer only. If the hardware has no available voices and no voice management flags are set, the call to DirectSoundsSecondaryBuffer8.Play fails. This flag cannot be combined with DSBPLAY_LOCSOFTWARE.

DSBPLAY_LOCSOFTWARE

Play this voice in a software buffer only. This flag cannot be combined with DSBPLAY_LOCHARDWARE or any DSBPLAY_TERMINATEBY flag.

DSBPLAY_LOOPING

Play from the play cursor to the end of the buffer, and restart at the beginning of the buffer. The buffer plays till explicitly stopped.

DSBPLAY_TERMINATEBY_DISTANCE

If the hardware has no available voices, a currently playing buffer will be stopped to make room for the new buffer. The buffer prematurely terminated will be selected from buffers that have the buffer's DSBCAPS_ MUTE3DATMAXDISTANCE flag set and are beyond their maximum distance. If there are no such buffers, the method fails.

DSBPLAY_TERMINATEBY_PRIORITY

If the hardware has no available voices, a currently playing buffer will be stopped to make room for the new buffer. ‹The buffer prematurely terminated will be the one with the lowest priority as set by the dwPriority parameter passed to IDirectSoundBuffer8::Play for the buffer.›

DSBPLAY_TERMINATEBY_TIME

If the hardware has no available voices, a currently playing buffer will be stopped to make room for the new buffer. The buffer prematurely terminated is the one with the least time left to play.