public:
     virtual HRESULT __fastcall EvaluateMode( dword pFlags, dword* pSecondsUntilTimeout );

• Description
• Parameters
• See Also

If you would like to submit additions or improvements to this page, click: admin@bcb-tools.com.

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

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.

SecondsUntilTimeout
The SecondUntilTimout parameter will reference the time remaining, in seconds, before the current mode is automatically failed.

TDx_Draw
TDx_Draw::StartModeTest()