Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
- Description
The TDx_Draw::EvaluateMode method is used in conjunction with TDx_Draw::StartModeTest() to evaluate the maximum refresh rate possible for each screen resolution using the current combination of display adapter and EDID monitor.
Call TDx_Draw::StartModeTest() to establish a set of testable resolutions and display the first video mode in that set. TDx_Draw::EvaluateMode() can then be used to step through the testable resolutions starting with the highest supported refresh rate for a given resolution. As soon as a given resolution passes the test any lower refresh rates for that resolution are skipped.
There is a 15 second timeout when the test is started or when a mode is passed or failed. Calling TDx_Draw::EvaluateMode() with the Flags parameter set to 0 will retrieve the time remaining without interfering with the current test.
Test termination or mode changes only occur when TDx_Draw::EvaluateMode() is called, but the current mode will always be failed if the call comes after the timeout period has passed.
On completion, the following messages may be returned.
DDERR_TESTFINISHED
DDERR_NEWMODE
If the method call fails, the OnError event will be triggered with one of the following values:
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_NOTFOUND
- Parameters
Flags
The Flags parameter defines flags indicating the status of the mode being tested.
The described effect applies when the flag is set.
-
DDEM_MODEFAILED
The video mode has failed or timed out at the current refresh rate.
DDEM_MODEPASSED
The video mode has passed the test at the current refresh rate.
The SecondUntilTimout parameter will reference the time remaining, in seconds, before the current mode is automatically failed.
- See Also
- Top
TDx_Draw_Library v2.00 Component Reference
|
|
|
[ TDx_Draw::EvaluateMode() ] [ next: FlipToGDISurface() ] [ prev: EnumSurfaces() ] public:
virtual HRESULT __fastcall EvaluateMode( dword pFlags, dword* pSecondsUntilTimeout );
TDX_DRAW::EVALUATEMODE()
[ component method ]
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com. |
|