VCL RAD DirectX for C++ Builder

Welcome to

www.tdxlibrary.org

Home of the
the TDx_Library...

=- RAD DirectX =-

"RAD DirectX"
for
C++ Builder

...

Welcome to tdxlibrary.org Latest News

Development Tools Demo Applications Step-By-Step Tutorials Component Reference

Register our Tools Available Downloads

Frequently Asked Questions Links to other sites Information about the tdxlibrary.org website


    TDx_Sound_Library v2.00 Component Reference

    -= Click to navigate the reference =-
    Go to the Welcome Page

    [ TDSBCaps::Flags ]     [ next: PlayCpuOverhead ]     [ prev: ErrorValue ]

    public:

        __property dword Flags = { read=FGetFlags, write=FSetFlags, default=0 };




    -= Go to the TDSBCaps description =-    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.



























Top

Welcome |  Latest News |  Tools |  Demos |  Tutorials |  Reference |  Register |  Downloads
FAQ |  Links |  Site Information

This page is Copyright © 2019 Darren John Dwyer, Australia. All Rights Reserved.
Borland C++ Builder, CBuilder, etc are Trademarks of Borland Corporation.
DirectX, DirectDraw, Windows, etc are Trademarks of Microsoft Corporation.