IDXGIDisplayControl interface (dxgi1_2.h)

  • Article

The IDXGIDisplayControl interface exposes methods to indicate user preference for the operating system's stereoscopic 3D display behavior and to set stereoscopic 3D display status to enable or disable.

We recommend that you not use IDXGIDisplayControl to query or set system-wide stereoscopic 3D settings in your stereoscopic 3D apps. Instead, for your windowed apps, call the IDXGIFactory2::IsWindowedStereoEnabled method to determine whether to render in stereo; for your full-screen apps, call the IDXGIOutput1::GetDisplayModeList1 method and then determine whether any of the returned display modes support rendering in stereo.

Inheritance

The IDXGIDisplayControl interface inherits from the IUnknown interface. IDXGIDisplayControl also has these types of members:

Methods

The IDXGIDisplayControl interface has these methods.

 
IDXGIDisplayControl::IsStereoEnabled

Retrieves a Boolean value that indicates whether the operating system's stereoscopic 3D display behavior is enabled.
IDXGIDisplayControl::SetStereoEnabled

Set a Boolean value to either enable or disable the operating system's stereoscopic 3D display behavior.

Remarks

Note  The IDXGIDisplayControl interface is only used by the Display app of the operating system's Control Panel or by control applets from third party graphics vendors. This interface is not meant for developers of end-user apps.
 
Note  The IDXGIDisplayControl interface does not exist for Windows Store apps.
 
Call QueryInterface from a factory object (IDXGIFactory, IDXGIFactory1 or IDXGIFactory2) to retrieve the IDXGIDisplayControl interface. The following code shows how. 
IDXGIDisplayControl * pDXGIDisplayControl;
hr = g_pDXGIFactory->QueryInterface(__uuidof(IDXGIDisplayControl), (void **)&pDXGIDisplayControl);

The operating system processes changes to stereo-enabled configuration asynchronously. Therefore, these changes might not be immediately visible in every process that calls IDXGIDisplayControl::IsStereoEnabled to query for stereo configuration. Control applets can use the IDXGIFactory2::RegisterStereoStatusEvent or IDXGIFactory2::RegisterStereoStatusWindow method to register for notifications of all stereo configuration changes.

Platform Update for Windows 7:  Stereoscopic 3D display behavior isn’t available with the Platform Update for Windows 7. For more info about the Platform Update for Windows 7, see Platform Update for Windows 7.

Requirements

Requirement Value
Minimum supported client Windows 8 and Platform Update for Windows 7 [desktop apps only]
Minimum supported server Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header dxgi1_2.h

See also

DXGI Interfaces

IUnknown