//-----------------------------------------------------------------------------
//
// Sample Name: RefreshRate Sample
//
// Copyright (c) 1999-2001 Microsoft Corporation. All rights reserved.
//
//-----------------------------------------------------------------------------
Description
===========
This example demonstrates basic usage of the IDirectDraw7::StartRefreshRate
and IDirectDraw7::EvaluateMode methods. Together, these methods allow an
application to explore what display modes and refresh rates the monitor
connected to this display device is able to display, though a manual
user-controlled process. The application will present the UI that asks
the user if the current mode under test is being displayed correctly by
the monitor.
Applications should use these methods when they are interested in using
higher refresh rates.
The basic idea is that DirectDraw will setup a list of modes to be tested
(based on the list the app passed in), and then sequentially test them
under application control. The app starts the test process, and then
calls IDirectDraw7::EvaluateMode continuously. DirectDraw will take care
of settings the modes. All the app has to do is SetCooperativeLevel
beforehand, and then handle surface loss and drawing the UI that asks the
user if they can see the current mode under test. DirectDraw returns
enough information from IDirectDraw7::EvalulateMode to allow the app to
know when to do these things, and when to stop testing. The app can pass
a flag to IDirectDraw7::EvaluateMode if the user happened to say they
could see the mode corretly, which will cause DirectDraw to mark the mode
as good and move on. DirectDraw may also decide that time as run out and
give up on a certain mode.
DirectDraw uses information at its disposal from any automated means to
make the testing process as short as possible, and applications only need
to test modes they are interested in.
Path
====
Source: DXSDK\Samples\Multimedia\DDraw\RefreshRate
Executable: DXSDK\Samples\Multimedia\DDraw\Bin
User's Guide
============
The user interface is a simple dialog box. First select the DirectDraw display
device. Then select which modes you would like to test, and click 'Test'.
Each display mode will be tested, and the user can select if the mode appears
correctly or not.
If the user makes a mistake, and accidently says YES when a mode cannot be seen,
or NO when a mode really can be seen (thus ending up with a lower refresh rate than
possible) this allows the user to reset the test results and try again.
Click the Exit button to exit the application.
LGram16
e067522598