MediaCenter.DirectXExclusive Property

Gets a value that indicates whether Windows Media Center is running in the DirectX exclusive mode.

Note   This property has been deprecated.

Syntax

  MediaCenter.DirectXExclusive

Property Value

A read/write Boolean value that is true if Windows Media Center is running in DirectX exclusive mode, and false if not.

Remarks

DirectX exclusive mode is a feature of the Microsoft DirectX API that enables the windowing system to be suspended so that drawing can be done directly to the screen. Exclusive mode allows Windows Media Center to take advantage of hardware acceleration for enhanced video performance. In HTML applications you can programmatically enter or leave exclusive mode. Temporarily leaving exclusive mode may occasionally become necessary when, for example, your users need to use the keyboard and mouse to address Windows security dialog boxes while installing your application.

Moving in or out of DirectX exclusive mode can take a second or two. When a mode change is initiated, the 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 2004 through Windows Vista

See Also