MediaCenter.ReEnterDirectXExclusiveMode Event
Raised when Windows Media Center loads a page.
Note This event has been deprecated.
Syntax
ReEnterDirectXExclusiveMode()
Remarks
This event enables an HTML page to specify whether Windows Media Center enters DirectX exclusive mode when the page loads. On a page transition (forward or backward), Windows Media Center calls this event. If the event is not implemented by the page or if the page returns true, Windows Media Center will enter exclusive mode if it is available. If the page implements the event and returns false, Windows Media Center will do nothing. Windows Media Center will not use this event to exit exclusive mode.
By default, Windows Media Center enters DirectX exclusive mode when loading a page if Windows Media Center is maximized. To prevent Windows Media Center from entering DirectX exclusive mode, include a function on the page called ReEnterDirectXExclusiveMode and have the function return false.
Moving in or out of DirectX exclusive mode can take a second or two. When a mode change is initiated, the MediaCenter.DirectXExclusive property may indicate the new state prematurely (before the video card has completed the mode switch) because of latencies in the DirectX system. For this reason, simply checking the DirectXExclusive property while processing the onLoad event may return inaccurate results. For pages that enter or exit exclusive mode when they are loaded, any code requiring the page to be in a particular mode should be performed after a delay, to allow for the transition to complete.
Requirements
Platform: HTML application hosted within Windows XP Media Center Edition 2005 through Windows Vista
See Also