D3DDDIARG_PRESENT1 struttura (d3dumddi.h)

Articolo
08/07/2023

Descrive una risorsa da visualizzare. Usato con la funzione pfnPresent1(D3D) da Windows Display Driver Model (WDDM) 1.3 e versioni successive dei driver di visualizzazione in modalità utente.

Sintassi

typedef struct _D3DDDIARG_PRESENT1 {
  [in] const D3DDDIARG_PRESENTSURFACE *phSrcResources;
  [in] UINT                           SrcResources;
  [in] HANDLE                         hDstResource;
       UINT                           DstSubResourceIndex;
  [in] D3DDDI_PRESENTFLAGS            Flags;
  [in] D3DDDI_FLIPINTERVAL_TYPE       FlipInterval;
       UINT                           Reserved;
  [in] const RECT                     *pDirtyRects;
  [in] UINT                           DirtyRects;
       UINT                           BackBufferMultiplicity;
} D3DDDIARG_PRESENT1;

Members

[in] phSrcResources

Matrice di handle non NULL e indici in base zero alla risorsa di origine da visualizzare o rilasciare. phSrcResources è sempre un handle valido per la visualizzazione di una risorsa.

[in] SrcResources

Numero di risorse di origine presenti nella matrice a cui punta phSrcResources.

[in] hDstResource

Handle alla risorsa di destinazione da visualizzare. Se NULL, la destinazione è sconosciuta e il driver miniport visualizzato determina la destinazione appena prima che venga elaborato il flusso di comandi hardware.

DstSubResourceIndex

[in] Indice in base zero nella risorsa di destinazione, specificato dall'handle nel membro hDstResource . Questo indice indica la sottoresource o la superficie da visualizzare.

[in] Flags

Struttura D3DDDI_PRESENTFLAGS che identifica, in flag di campo a bit, come visualizzare.

[in] FlipInterval

Valore D3DDDI_FLIPINTERVAL_TYPE tipizzato che indica l'intervallo di capovolgimento, ovvero se il capovolgimento si verifica dopo zero, uno, due, tre o quattro sincronizzazioni verticali.

Reserved

Questo membro è riservato e deve essere impostato su zero.

[in] pDirtyRects

Puntatore a una matrice di rettangoli sporchi (RECTs), rispetto al rettangolo di origine SrcRect, che indicano la parte del piano di sovrapposizione modificato.

Il driver può usare questo membro per eseguire ottimizzazioni, anche se non è necessario usare le informazioni sul rettangolo sporco. Tuttavia, il driver non deve mai non riuscire una chiamata di funzione in base ai rettangoli sporchi forniti.

[in] DirtyRects

Numero di rettangoli sporchi nella matrice a cui punta pDirtyRects.

BackBufferMultiplicity

Numero di buffer back fisico per buffer back logico.