DisplayDevice.CreateSimpleScanoutWithDirtyRectsAndOptions Método

Definición

Espacio de nombres:

Windows.Devices.Display.Core

Crea un objeto DisplayScanout que proporciona una encapsulación inmutable de parámetros necesarios para presentar un marco a un DisplaySource.

public:
 virtual DisplayScanout ^ CreateSimpleScanoutWithDirtyRectsAndOptions(DisplaySource ^ source, DisplaySurface ^ surface, unsigned int subresourceIndex, unsigned int syncInterval, IIterable<RectInt32> ^ dirtyRects, DisplayScanoutOptions options) = CreateSimpleScanoutWithDirtyRectsAndOptions;

DisplayScanout CreateSimpleScanoutWithDirtyRectsAndOptions(DisplaySource const& source, DisplaySurface const& surface, uint32_t const& subresourceIndex, uint32_t const& syncInterval, IIterable<RectInt32> const& dirtyRects, DisplayScanoutOptions const& options);

public DisplayScanout CreateSimpleScanoutWithDirtyRectsAndOptions(DisplaySource source, DisplaySurface surface, uint subresourceIndex, uint syncInterval, IEnumerable<RectInt32> dirtyRects, DisplayScanoutOptions options);

function createSimpleScanoutWithDirtyRectsAndOptions(source, surface, subresourceIndex, syncInterval, dirtyRects, options)

Public Function CreateSimpleScanoutWithDirtyRectsAndOptions (source As DisplaySource, surface As DisplaySurface, subresourceIndex As UInteger, syncInterval As UInteger, dirtyRects As IEnumerable(Of RectInt32), options As DisplayScanoutOptions) As DisplayScanout

Parámetros

source

DisplaySource

DisplaySource al que se va a presentar contenido.

surface

DisplaySurface

Superficie primaria.

subresourceIndex

UInt32

unsigned int

uint32_t

Relacionado con el concepto de subrecursos de Direct3D. Con este índice, puede especificar qué subrecurso dentro de DisplaySurface se debe usar para el examen, en caso de que haya varios subrecursos.

La única manera de tener un DisplaySurface que tenga varios subrecursos es crear el DisplaySurface con la marca isStereo (consulte CreateWithProperties) o para abrir un ID3D11Texture2D mediante API en IDisplayDeviceInterop.

El valor más común para subresourceindex será 0, lo que indica que no se necesita ningún subrecurso o está disponible.

syncInterval

UInt32

unsigned int

uint32_t

Entero que especifica cómo sincronizar la presentación de un marco con el espacio en blanco vertical de la pantalla.

SyncInterval == 0. La presentación se produce en el siguiente espacio en blanco vertical desde la pantalla. Si hay otros regalos en la cola con el valor = 0, esos regalos se descartan. SyncInterval == 0, con DisplayScanoutOptions::AllowTearing. La presentación se produce inmediatamente; no hay ninguna sincronización con el marco anterior. Esto puede provocar un desgarro visible. SyncInterval == de 1 a 4. Sincronice la presentación para al menos n espacios en blanco verticales de la pantalla.

dirtyRects

IIterable<RectInt32>

IEnumerable<RectInt32>

Rectángulos sucios que proporcionan una sugerencia al controlador de gráficos que indica qué regiones de la principal están cambiando. Esto puede ser utilizado por el controlador para reducir la cantidad de ancho de banda en el transporte de pantalla subyacente, por lo que debe pasar rectángulos válidos que abarcan completamente todos los píxeles modificados en un marco.

Se trata de una optimización y, si el cliente directDisplay no realiza un seguimiento de rectángulos sucios, puede pasar null para dirtyRects y el sistema operativo considerará que como un marco completo sucio (lo que significa que se modifican todos los píxeles del búfer principal). Si pasa una lista vacía para dirtyRects , significa que no se han cambiado píxeles en el búfer principal y el controlador de gráficos podría optar por optimizar el examen de este búfer principal.

options

DisplayScanoutOptions

Marcas que pueden especificar varias opciones para el DisplayScanout que se va a crear. DisplayScanoutOptions.AllowTearing solo es válido si syncInterval es 0.

Devoluciones

DisplayScanout

Valor displayScanout .

Requisitos de Windows

Familia de dispositivos	Windows 11 (se introdujo en la versión 10.0.22000.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v14.0)