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

    [ TDSBufferDesc::Flags ]     [ next: Format ]     [ prev: ErrorValue ]

    public:

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




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



























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.