struttura DXGK_MULTIPLANE_OVERLAY_PLANE3 (d3dkmddi.h)

Specifica un piano di sovrimpressione da visualizzare in una chiamata alla funzione DxgkDdiSetVidSourceAddressWithMultiPlaneOverlay3.

Sintassi

typedef struct _DXGK_MULTIPLANE_OVERLAY_PLANE3 {
  UINT                                LayerIndex;
  ULONGLONG                           PresentId;
  DXGK_PLANE_SPECIFIC_INPUT_FLAGS     InputFlags;
  DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS    OutputFlags;
  UINT                                MaxImmediateFlipLine;
  UINT                                ContextCount;
  DXGK_PRIMARYCONTEXTDATA             **ppContextData;
  UINT                                DriverPrivateDataSize;
  PVOID                               pDriverPrivateData;
  DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 PlaneAttributes;
} DXGK_MULTIPLANE_OVERLAY_PLANE3;

Membri

LayerIndex

Indice in base zero del piano di sovrimpressione da visualizzare. Il piano superiore (nella direzione z) ha indice zero. I valori di indice dei piani devono essere sequenziali dall'alto verso il basso.

PresentId

Identificatore a 64 bit per piano usato dal driver per segnalare il completamento del comando di sovrimpressione.

InputFlags

Struttura DXGK_PLANE_SPECIFIC_INPUT_FLAGS che identifica le operazioni di visualizzazione specifiche del piano da eseguire.

OutputFlags

Struttura DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS contenente lo stato restituito dal driver.

MaxImmediateFlipLine

La linea di visualizzazione che indica se un capovolgimento VSYNC deve essere promosso a un capovolgimento immediato, dove la riga 0 corrisponde al primo pixel attivo del fotogramma. Questo valore viene ignorato per i capovolgimenti non VSYNC.

Questo valore è -1 quando la promozione da un capovolgimento VSYNC a un capovolgimento immediato non è desiderata. In questo caso, l'inversione attenderà sempre il VSYNC successivo.

Per un valore diverso da -1, il driver deve alzare di livello questo capovolgimento a un capovolgimento immediato se HW non ha ancora avviato la lettura dalla linea di visualizzazione specificata. I valori 0 possono essere promossi a capovolgimenti immediati se il modulo HW ha registri di latch per il frame di visualizzazione corrente, ma non ha ancora avviato la scansione del primo pixel attivo.

Il valore della riga di visualizzazione è relativo alla modalità fisica impostata. Se la visualizzazione esegue il ridimensionamento, la linea di visualizzazione è relativa alle dimensioni dopo l'applicazione del ridimensionamento.

Quando un capovolgimento VSYNC viene alzato di livello a un capovolgimento immediato, il driver deve impostare DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS. FlipConvertedToImmediate su TRUE.

ContextCount

Numero di contesti nella matrice specificata dal membro Context.

ppContextData

Matrice di handle per i contesti che hanno contribuito a un'operazione di visualizzazione.

DriverPrivateDataSize

Dimensioni dei dati del driver privato.

pDriverPrivateData

Dati dei driver privati.

PlaneAttributes

Struttura di tipo DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 che specifica gli attributi del piano di sovrapposizione.

Fabbisogno

Requisito	Valore
intestazione	d3dkmddi.h