Share via


DisplayDevice.CreateSimpleScanout Method

Definition

Creates a DisplayScanout object that can be used to present a full-screen surface directly to the screen.

public DisplayScanout CreateSimpleScanout(DisplaySource pSource, DisplaySurface pSurface, uint SubResourceIndex, uint SyncInterval);

Parameters

pSource
DisplaySource

A DisplaySource to present full-screen content to.

pSurface
DisplaySurface

A full-screen primary surface.

SubResourceIndex
UInt32

Related to Direct3D's concept of subresources. Using this index, you can specify which subresource within the DisplaySurface should be used for scanout, in the event that there are multiple subresources.

The only way to have a DisplaySurface that has multiple subresources is either to create the DisplaySurface with the isStereo flag (see CreateWithProperties), or to open an ID3D11Texture2D using APIs in IDisplayDeviceInterop.

The most common value for subresourceindex will be 0, which indicates that no subresource is needed or available.

SyncInterval
UInt32

An integer that specifies how to synchronize presentation of a frame with the vertical blank of the display.

SyncInterval == 0. Presentation happens on the next vertical blank from the display. If there are other presents in the queue with value = 0, then those presents are discarded. SyncInterval == 0, with DisplayScanoutOptions::AllowTearing. The presentation occurs immediately; there is no synchronization with the previous frame. This can cause visible tearing. SyncInterval == 1 through 4. Synchronize presentation for at least n vertical blanks of the display.

Returns

A DisplayScanout value.

Applies to

Product Versions
WinRT Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100