Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
|
TDx_Sound_Library v2.00 Component Reference
|
|
[ TDSBCaps::Flags ]
[ next: PlayCpuOverhead ]
[ prev: ErrorValue ]
public:
__property dword Flags = { read=FGetFlags, write=FSetFlags, default=0 };
TDSBCAPS::FLAGS
[ component property ]
- Description
The Flags property defines flags specifying the capabilities of the sound buffer.
The described effect applies when the flag is set.
For optimum performance only specify control options that will be used.
Attempts to use a control that is not set on a buffer will result in the method failing.
- Flags
DSBCAPS_CTRL3D
The buffer is a primary or 3D secondary buffer.
For this to be a primary buffer, DSBCAPS_PRIMARYBUFFER should be set in TDSBufferDesc::Flags.
DSBCAPS_CTRLFREQUENCY
The buffer has frequency control capability.
Frequency Control control is the ability to modify the frequency, in samples per second, at which the buffer is playing.
DSBCAPS_CTRLPAN
The buffer has pan control capability.
Pan control is the ability to modify the relative values of the left and right audio channels.
DSBCAPS_CTRLPOSITIONNOTIFY
The buffer has position notification capability.
Position notification is the ability to set triggers, which activate specified events, on reaching certain positions or conditions within a sound buffer.
Setting DSBCAPS_CTRLPOSITIONNOTIFY when the hardware uses VxD drivers forces the buffer to be a software buffer.
VxD drivers don't support the notifications.
WDM drivers do support notifications so the buffer may be located in hardware memory if available.
Calling TDx_SoundBuffer::Play() with DSBPLAY_LOCHARDWARE will fail if this flag is set.
DSBCAPS_CTRLVOLUME
The buffer has volume control capability.
Volume control is the ability to modify the volume of a sound buffer.
DSBCAPS_GETCURRENTPOSITION2
TDx_SoundBuffer::GetCurrentPosition() uses the new behavior of the play cursor and thus return a much more accurate position.
This flag should always be set unless compatability with DirectX 1 is required.
This flag only affects emulated sound cards.
DSBCAPS_GLOBALFOCUS
The buffer is a global sound buffer.
Global sound buffers will continue to play even when the focus is switched to another application, unless that application is utilizing the DSSCL_EXCLUSIVE or DSSCL_WRITEPRIMARY cooperative levels.
DSBCAPS_LOCDEFER
The location of the buffer in hardware or software memory can be decided when the buffer is played.
DSBCAPS_LOCHARDWARE
The buffer is located in hardware memory and uses hardware mixing.
DSBCAPS_LOCSOFTWARE
The buffer is located in software memory and uses software mixing.
DSBCAPS_MUTE3DATMAXDISTANCE
The buffer will cease playing when its maximum distance is exceeded.
This option prevents the wasting of processor time by not calculating and mixing sounds that are effectively inaudible.
DSBCAPS_PRIMARYBUFFER
The buffer is a primary sound buffer.
DSBCAPS_STATIC
The buffer will be used for static sound data.
A sound buffer without this flag set will be a streaming sound buffer.
DSBCAPS_STICKYFOCUS
The buffer has a sticky focus.
Having a sticky focus means that an application will continue to play any sticky focus buffers it has when the user switches to another application, as long as the new focus application doesnt utilize DirectSound.
- See Also
- Top
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com.
|
|