VCL RAD DirectX for C++ Builder

Welcome to

www.tdxlibrary.org

Home of the
the TDx_Library...

=- RAD DirectX =-

"RAD DirectX"
for
C++ Builder

...

Welcome to tdxlibrary.org Latest News

Development Tools Demo Applications Step-By-Step Tutorials Component Reference

Register our Tools Available Downloads

Frequently Asked Questions Links to other sites Information about the tdxlibrary.org website


    TDx_Draw_Library v2.00 Component Reference

    -= Click to navigate the reference =-
    Go to the Welcome Page

    [ TDx_Draw::StartModeTest() ]     [ next: TestCooperativeLevel() ]     [ prev: SetDisplayMode() ]

    public:

         virtual HRESULT __fastcall StartModeTest( SIZE* pModesToTest, dword pNumEntries, dword pFlags );





    -= Go to the TDx_Draw description =-    TDX_DRAW::STARTMODETEST()   [ component method ]

    • Description

        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

        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





    If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com.



























Top

Welcome |  Latest News |  Tools |  Demos |  Tutorials |  Reference |  Register |  Downloads
FAQ |  Links |  Site Information

This page is Copyright © 2019 Darren John Dwyer, Australia. All Rights Reserved.
Borland C++ Builder, CBuilder, etc are Trademarks of Borland Corporation.
DirectX, DirectDraw, Windows, etc are Trademarks of Microsoft Corporation.