struttura D3DDDIARG_PRESENT1 (d3dumddi.h)

Articolo
02/06/2025

Descrive una risorsa da visualizzare. Usato con la funzione pfnPresent1(D3D) da Windows Display Driver Model (WDDM) 1.3 e versioni successive.

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;

Membri

[in] phSrcResources

Matrice diNULL handle 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 nella matrice a cui punta phSrcResources.

[in] hDstResource

Handle per la risorsa di destinazione da visualizzare. Se NULL, la destinazione è sconosciuta e il driver miniport di visualizzazione determina la destinazione appena prima dell'elaborazione del flusso di comandi hardware.

DstSubResourceIndex

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

[in] Flags

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

[in] FlipInterval

Valore D3DDDI_FLIPINTERVAL_TYPE-typed che indica l'intervallo di capovolgimento, ovvero se lo scorrimento 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 dirty (RECTs), rispetto al rettangolo di origine SrcRect, che indicano la parte del piano di sovrimpressione modificato.

Il driver può usare questo membro per eseguire ottimizzazioni, anche se non è necessario usare le informazioni sul rettangolo dirty. Tuttavia, il driver non dovrebbe mai avere esito negativo di una chiamata di funzione in base ai rettangoli dirty forniti.

[in] DirtyRects

Numero di rettangoli dirty nella matrice a cui punta pDirtyRects.

BackBufferMultiplicity

Numero di buffer nascosto fisico per buffer back logico.