Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
|
TDx_Draw_Library v2.00 Component Reference
|
|
[ TDx_DrawSurface::PageLock() ]
[ next: PageUnlock() ]
[ prev: Lock() ]
public:
virtual bool __fastcall PageLock();
TDX_DRAWSURFACE::PAGELOCK()
[ component method ]
- Description
The
TDx_DrawSurface::PageLock
method
will
prevent
a
system
memory
surface
from
being
paged
out
while
a
DMA
blit
is
taking
place.
The
lock
count
for
the
surface
will
be
incremented.
Use
TDx_DrawSurface::PageUnlock()
to
decrement
the
lock
count.
Once
the
lock
count
reaches
zero
the
surface
is
unlocked
and
can
again
be
paged
out
by
the
operating
system.
Only
non-primary
system
memory
surfaces
can
be
PageLocked.
Calling
this
method
on
display
memory
surfaces
will
do
nothing
other
than
return
without
error.
PageLock
must
be
held
before
using
DMA
support,
otherwise
the
blit
will
use
software
emulation.
PageLocking
excessive
amounts
of
memory
can
seriously
impede
operating
system
performance.
If
the
method
call
fails,
the
OnError
event
will
be
triggered
with
one
of
the
following
values:
DDERR_CANTPAGELOCK
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_SURFACELOST
- Parameters
- See Also
- Top
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com.
|
|