Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
|
TDx_Sound_Library v2.00 Component Reference
|
|
[ TDSBufferDesc::Flags ]
[ next: Format ]
[ prev: ErrorValue ]
public:
__property dword Flags = { read=FGetFlags, write=FSetFlags, default=0 };
TDSBUFFERDESC::FLAGS
[ component property ]
- Description
The Flags property defines flags indicating the capabilities to be included in the new sound buffer.
The described effect applies when the flag is set.
One or more of the flags must be 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 to be a primary buffer or a 3D secondary buffer.
For this to be a primary buffer, DSBCAPS_PRIMARYBUFFER must be set.
DSBCAPS_CTRLFREQUENCY
The buffer is to have frequency control capability.
Frequency control is the ability to modify the frequency, in samples per second, at which the buffer is playing.
DSBCAPS_CTRLPAN
The buffer is to have 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 located in software.
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 is to have 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 to be 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.
Buffers using the new Dx7 voice allocation and management features need to set this flag.
DSBCAPS_LOCHARDWARE
The buffer is to be located in hardware memory and use hardware mixing.
This flag is optional and mutually exclusive with DSBCAPS_LOCSOFTWARE.
If there are insufficient hardware resources when this buffer is created, the creation request will fail.
It is up to the application to ensure that a mixing channel will be available for this buffer, availability is not guaranteed.
DSBCAPS_LOCSOFTWARE
The buffer is to be located in software memory and use software mixing.
This flag is optional and mutually exclusive with DSBCAPS_LOCSOFTWARE.
DSBCAPS_MUTE3DATMAXDISTANCE
The buffer is to cease playing when the maximum distance is exceeded.
This option prevents the wasting wasting of processor time by not calculating and mixing sounds that are effectively inaudible.
DSBCAPS_PRIMARYBUFFER
The buffer is to be a primary sound buffer.
Any buffer created will be a secondary buffer unless this flag is set,
DSBCAPS_STATIC
The buffer is to be used for static sound data.
If this flag is not set the buffer will be a streaming sound buffer.
Unless otherwise specified, an attempt will be made to locate this buffer in hardware memory.
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.
|
|