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_Draw_Library v2.00 Component Reference

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

    [ TDx_DrawSurface::Lock() ]     [ next: PageLock() ]     [ prev: LoadFromSurface() ]

    public:

         virtual bool __fastcall Lock( TRect* pDestRect, TDDSurfaceDesc* pSurfaceDesc, dword pFlags );





    -= Go to the TDx_DrawSurface description =-    TDX_DRAWSURFACE::LOCK()   [ component method ]

    • Description
    • Parameters

        DestRect
        The DestRect parameter references a TRect defining the portion of the surface that is to be locked.
        Set this parameter to NULL to lock an entire surface.

        SurfaceDesc
        The SurfaceDesc parameter references a TDDSurfaceDesc component for holding the description of the locked surface if this method returns successfully.

        Flags
        The Flags parameter defines flags indicating the type of lock to be performed.
        The described effect applies when the flag is set.

          DDLOCK_DISCARDCONTENTS
          No assumptions are made about vertex buffer contents during this lock.

          This flag is only used in relation to TDx_3D vertex-buffer locks and is useful when clearing the vertex buffer and filling it with new data.
          TDx_3D or the driver may provide an alternative memory area for the vertex buffer.

          DDLOCK_DONOTWAIT
          Continue with application execution immediately after the lock is attempted without waiting for a return value indicating a successful lock.

          DDLOCK_EVENT
          This flag has not yet been implemented by Microsoft.

          DDLOCK_NOOVERWRITE
          No 3D vertices referred to since the start of the frame or the last lock without this flag are modified during this lock.
          This flag is only used in relation to TDx_3D vertex-buffer locks and is useful when appending data to the vertex buffer.

          DDLOCK_NOSYSLOCK
          Win16Lock will not be taken unless it is unavoidable.
          This flag does not apply when attempting to lock the primary surface.

          DDLOCK_READONLY
          The locked surface will only be read from.

          DDLOCK_SURFACEMEMORYPTR
          A memory pointer to the top of the rectangle specified in the DestRect parameter of this method will be returned.
          Set the DestRect parameter of this method to NULL to return a pointer to the top of the surface.

          DDLOCK_WAIT
          The lock will wait until it can be obtained or an error other than DDERR_WASSTILLDRAWING occurs.

          DDLOCK_WRITEONLY
          The locked surface will only be written to.


    • 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.