structure D3DDDIARG_PRESENT1 (d3dumddi.h)

Article
08/07/2023

Décrit une ressource à afficher. Utilisé avec la fonction pfnPresent1(D3D) par windows Display Driver Model (WDDM) 1.3 et les pilotes d’affichage en mode utilisateur ultérieurs.

Syntaxe

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;

Membres

[in] phSrcResources

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

[in] SrcResources

Nombre de ressources sources qui se trouvent dans le tableau pointé vers phSrcResources.

[in] hDstResource

Handle de la ressource de destination à afficher. Si la valeur est NULL, la destination est inconnue et le pilote miniport d’affichage détermine la destination juste avant le traitement du flux de commandes matérielles.

DstSubResourceIndex

[in] Index de base zéro dans la ressource de destination, qui est spécifié par le handle dans le membre hDstResource . Cet index indique la sous-ressource ou la surface à afficher.

[in] Flags

Structure D3DDDI_PRESENTFLAGS qui identifie, dans les indicateurs de champ binaire, comment afficher.

[in] FlipInterval

Valeur de type D3DDDI_FLIPINTERVAL_TYPE qui indique l’intervalle de basculement (autrement dit, si le basculement 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), par rapport 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 logique.