TDx_Draw::TestCooperativeLevel() Reference

BCB-Tools.com

Home of
RAD DirectX

C++ Builder wrapping DirectX

...

Please Register

So we can
create more

the TDx_Library
the TDx9_Library

TDx_Draw_Library v1.90 Component Reference

Component: TDX_DRAW::TESTCOOPERATIVELEVEL()

[ TDx_Draw ] [ next: WaitForVerticalBlank() ] [ prev: StartModeTest() ]

public:
virtual HRESULT __fastcall TestCooperativeLevel();

Description
See Also

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

DESCRIPTION

Top See Also

The TDx_Draw::TestCooperativeLevel method is used to determine if a program can restore/use its surfaces.

A fullscreen exclusive application will receive DDERR_NOEXCLUSIVEMODE if ALT-TAB is pressed.

A minimised normal mode application will receive DDERR_EXCLUSIVEMODEALREADYSET if another application has exclusive mode.

TDx_Draw::TestCooperativeLevel() should be used until DD_OK is returned, before any operations are performed. Use TApplication.ProcessMessages() to reduce CPU usage during the TDx_Draw::TestCooperativeLevel() loop.

If the method call fails, the OnError event will be triggered with one of the following values:
DDERR_INVALIDOBJECT
DDERR_EXCLUSIVEMODEALREADYSET
DDERR_NOEXCLUSIVEMODE
DDERR_WRONGMODE