DXGI_DDI_ARG_PRESENT1 structure (dxgiddi.h)

Article
08/07/2023

Décrit une ressource à afficher. Utilisé avec la fonction pfnPresent1(DXGI) par le modèle de pilote d’affichage Windows (WDDM) 1.3 et les pilotes d’affichage en mode utilisateur ultérieurs.

Syntaxe

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;

Membres

[in] hDevice

Handle du périphérique d’affichage (contexte graphique) sur lequel le pilote effectue la présentation. Le runtime Direct3D transmet ce handle au pilote dans le membre hDrvDevice de la structure D3D10DDIARG_CREATEDEVICE lorsque le runtime appelle la fonction CreateDevice(D3D10) du pilote pour créer le périphérique d’affichage.

[in] phSurfacesToPresent

Tableau de handles non NULL et d’index de base zéro pour la ressource source à afficher ou à libérer. phSurfacesToPresent est toujours un handle valide pour une ressource à afficher.

[in] SurfacesToPresent

Tableau de surfaces à présenter. Ne doit pas être égal à zéro.

[in] hDstResource

Handle de la ressource de destination à afficher. hDstResource peut être NULL si la destination est inconnue ; Le mode noyau détermine la destination juste avant d’envoyer le flux de commandes matérielles via DMA au processeur graphique.

Lorsque de nombreuses ressources sont présentées, hDstResource a la valeur NULL et le pilote doit traduire uniquement le dernier handle de ressource source pour une utilisation avec la fonction pfnPresentCb .

[in] DstSubResourceIndex

Index de base zéro dans la ressource de destination, que le handle dans le membre hDstResource spécifie. L’index DstSubResourceIndex indique la sous-ressource ou la surface à afficher.

[in] pDXGIContext

Handle pour le contexte DXGI. Cette poignée est opaque pour le pilote. Le pilote doit passer le handle dans ce membre en tant que membre pDXGIContext de la structure DXGIDDICB_PRESENT lorsque le pilote appelle la fonction pfnPresentCbDXGI .

[in] Flags

Structure DXGI_DDI_PRESENT_FLAGS qui identifie, dans les indicateurs de champ binaire, comment effectuer l’opération actuelle.

[in] FlipInterval

Valeur de type DXGI_DDI_FLIP_INTERVAL_TYPE qui indique l’intervalle de retournement (autrement dit, si le retournement se produit après zéro, une, deux, trois ou quatre synchronisations verticales).

Reserved

Ce membre est réservé et doit être défini sur zéro.

[in] pDirtyRects

Pointeur vers un tableau de rectangles sale (RECT), relatif au rectangle source SrcRect, qui indique la partie du plan de superposition qui a changé.

Le pilote peut utiliser ce membre pour effectuer des optimisations, bien qu’il ne soit pas nécessaire d’utiliser les informations de rectangle sale. Toutefois, le pilote ne doit jamais échouer un appel de fonction basé sur les rectangles sale fournis.

[in] DirtyRects

Nombre de rectangles sale dans le tableau pointé par pDirtyRects.

BackBufferMultiplicity

Nombre de mémoires tampons d’arrière-plan physiques par mémoire tampon d’arrière-plan logique.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1,WDDM 1.3 et versions ultérieures
Serveur minimal pris en charge	Windows Server 2012 R2
En-tête	dxgiddi.h (include D3d10umddi.h)