DisplayDevice.CreateSimpleScanoutWithDirtyRectsAndOptions Metodo

Riferimento

Definizione

Spazio dei nomi:: Windows.Devices.Display.Core

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Crea un oggetto DisplayScanout che fornisce un incapsulamento non modificabile dei parametri necessari per presentare un frame a 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

Parametri

source: DisplaySource

Oggetto DisplaySource a cui presentare il contenuto.

surface: DisplaySurface

Superficie primaria.

subresourceIndex: UInt32
unsigned int

uint32_t

Correlato al concetto di sottorisorse di Direct3D. Usando questo indice, è possibile specificare quale sottorisorsa all'interno di DisplaySurface deve essere usata per l'analisi, nel caso in cui siano presenti più sottorisorse.

L'unico modo per avere un DisplaySurface con più sottorisorse consiste nel creare DisplaySurface con il flag isStereo (vedere CreateWithProperties) o per aprire un ID3D11Texture2D usando le API in IDisplayDeviceInterop.

Il valore più comune per subresourceindex sarà 0, che indica che non è necessaria alcuna sottorisorsa o disponibile.

syncInterval: UInt32
unsigned int

uint32_t

Intero che specifica come sincronizzare la presentazione di una cornice con lo spazio verticale dello schermo.

SyncInterval == 0. La presentazione viene eseguita sul successivo vuoto verticale dalla visualizzazione. Se nella coda sono presenti altri regali con valore = 0, tali regali vengono eliminati. SyncInterval == 0, con DisplayScanoutOptions::AllowTearing. La presentazione si verifica immediatamente; non esiste alcuna sincronizzazione con il frame precedente. Ciò può causare la rottura visibile. SyncInterval == da 1 a 4. Sincronizzare la presentazione per almeno n spazi vuoti verticali dello schermo.

dirtyRects: IIterable<RectInt32>

IEnumerable<RectInt32>

Rettangoli sporchi che forniscono un suggerimento al driver grafico che indica quali aree del database primario stanno cambiando. Ciò potrebbe essere usato dal driver per ridurre la quantità di larghezza di banda nel trasporto di visualizzazione sottostante, pertanto è necessario passare rettangoli validi che includono completamente tutti i pixel modificati in un frame.

Si tratta di un'ottimizzazione e se il client DirectDisplay non tiene traccia dei rettangoli dirty, è possibile passare null per dirtyRects e il sistema operativo considererà che come dirty frame completo (vale a dire che tutti i pixel nel buffer primario vengono modificati). Se si passa un elenco vuoto per dirtyRects , significa che non sono stati modificati pixel nel buffer primario e il driver grafico potrebbe scegliere di ottimizzare l'analisi di questo buffer primario.

options: DisplayScanoutOptions

Flag che possono specificare varie opzioni per la creazione di DisplayScanout . DisplayScanoutOptions.AllowTearing è valido solo se syncInterval è 0.

Restituisce

DisplayScanout

Valore DisplayScanout .

Requisiti Windows

Famiglia di dispositivi	Windows 11 (è stato introdotto in 10.0.22000.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v14.0)

Si applica a

Condividi tramite