[ TDx_Draw ]
[ next: TestCooperativeLevel() ]
[ prev: SetDisplayMode() ]
public:
virtual HRESULT __fastcall StartModeTest( SIZE* pModesToTest, dword pNumEntries, dword pFlags );
If you would like to submit additions or improvements to this page, click: admin@bcb-tools.com.
DESCRIPTION
Top
Parameters
See Also
The
TDx_Draw::StartModeTest
method
will
update
the
refresh
rate
information
in
the
system
registry
by
testing
the
current
display
adapter
/
EDID
monitor
combination.
Once
the
testable
resolutions
are
defined
using
this
method,
TDx_Draw::EvaluateMode()
can
be
used
to
test
each
resolution
for
the
maximum
refresh
rate
that
can
be
displayed.
The
changed
registry
settings
may
change
the
results
returned
by
TDx_Draw::EnumDisplayModes()
when
it
is
called
with
DDEDM_REFRESHRATES
set.
No
testing
and
a
return
value
of
DDERR_TESTFINISHED
will
result
if
the
monitor
being
tested
is
not
EDID
compliant.
No
modes
will
be
tested
if
the
EDID
table
does
not
contain
values
higher
than
60
Hz
and
refresh
rates
higher
than
100
Hz
will
only
be
tested
if
the
EDID
table
contains
values
higher
than
85
Hz.
Set
the
parameters
to
NULL,
0
and
0
to
clear
existing
refresh
rate
information
from
the
registry.
If
the
method
call
fails,
the
OnError
event
will
be
triggered
with
one
of
the
following
values:
DDERR_CURRENTLYNOTAVAIL
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_NOEXCLUSIVEMODE
DDERR_NOTFOUND
DDERR_TESTFINISHED
Calling
this
method
with
DDSMT_ISTESTREQUIRED
set
may
return
one
of
these
values:
DDERR_NEWMODE
DDERR_NODRIVERSUPPORT
DDERR_NOMONITORINFORMATION
DDERR_TESTFINISHED
PARAMETERS
Top
See Also
ModesToTest
The ModesToTest parameter references an array of SIZE elements defining the screen resolutions to be tested.
NumEntries
The NumEntries parameter defines how many elements the array referenced by the ModesToTest parameter contains.
Flags
The Flags parameter defines a flag indicating whether a test should be initiated.
The described effect applies when the flag is set.
DDSMT_ISTESTREQUIRED
The method will return a value indicating whether it is neccessary (or possible) to test the resolutions referenced by the ModesToTest parameter, without initiating any tests.
SEE ALSO
Top
Parameters
Component:
TDX_DRAW::STARTMODETEST()
