struttura DXGI_DDI_ARG_PRESENT1 (dxgiddi.h)

Articolo
02/06/2025

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

Sintassi

typedef struct DXGI_DDI_ARG_PRESENT1 {
  [in] DXGI_DDI_HDEVICE                  hDevice;
  [in] const DXGI_DDI_ARG_PRESENTSURFACE *phSurfacesToPresent;
  [in] UINT                              SurfacesToPresent;
  [in] DXGI_DDI_HRESOURCE                hDstResource;
  [in] UINT                              DstSubResourceIndex;
  [in] void                              *pDXGIContext;
  [in] DXGI_DDI_PRESENT_FLAGS            Flags;
  [in] DXGI_DDI_FLIP_INTERVAL_TYPE       FlipInterval;
       UINT                              Reserved;
  [in] const RECT                        *pDirtyRects;
  [in] UINT                              DirtyRects;
       UINT                              BackBufferMultiplicity;
} DXGI_DDI_ARG_PRESENT1;

Membri

[in] hDevice

Handle per il dispositivo di visualizzazione (contesto grafico) in cui il driver esegue la presentazione. Il runtime Direct3D passa questo handle al driver nel membro hDrvDevice della struttura D3D10DDIARG_CREATEDEVICE quando il runtime chiama la funzione CreateDevice(D3D10) del driver per creare il dispositivo di visualizzazione.

[in] phSurfacesToPresent

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

[in] SurfacesToPresent

Matrice di superfici da presentare. Non deve essere zero.

[in] hDstResource

Handle per la risorsa di destinazione da visualizzare. hDstResource può essere null se la destinazione è sconosciuta; La modalità kernel determinerà la destinazione subito prima di inviare il flusso dei comandi hardware tramite DMA al processore grafico.

Quando vengono presentate molte risorse, hDstResource verrà NULLe il driver deve convertire solo l'ultimo handle di risorse di origine da usare con la funzione pfnPresentCb.

[in] DstSubResourceIndex

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

[in] pDXGIContext

Handle per il contesto DXGI. Questo handle è opaco per il driver. Il driver deve passare l'handle in questo membro come membro pDXGIContext della struttura DXGIDDICB_PRESENT quando il driver chiama la funzione pfnPresentCbDXGI.

[in] Flags

Struttura DXGI_DDI_PRESENT_FLAGS che identifica, in flag di campo di bit, come eseguire l'operazione corrente.

[in] FlipInterval

Valore DXGI_DDI_FLIP_INTERVAL_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.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8.1,WDDM 1.3 e versioni successive
server minimo supportato	Windows Server 2012 R2
intestazione	dxgiddi.h (include D3d10umddi.h)