structure D3DDDIARG_PRESENT1 (d3dumddi.h)

Article
02/06/2025

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

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 d’index null non-NULL et d’index de base zéro à la ressource source à afficher ou à libérer. phSrcResources est toujours un handle valide pour qu’une ressource s’affiche.

[in] SrcResources

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

[in] hDstResource

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

DstSubResourceIndex

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

[in] Flags

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

[in] FlipInterval

Valeur D3DDDI_FLIPINTERVAL_TYPE-typée qui indique l’intervalle de retour (autrement dit, si le retour se produit après zéro, un, 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 sales (RECTs), par rapport au rectangle source SrcRect, qui indiquent la partie du plan de superposition qui a changé.

Le pilote peut utiliser ce membre pour effectuer des optimisations, mais il n’est pas nécessaire d’utiliser les informations de rectangle sale. Toutefois, le pilote ne doit jamais échouer un appel de fonction en fonction des rectangles incorrects fournis.

[in] DirtyRects

Nombre de rectangles sales dans le tableau pointés par pDirtyRects.

BackBufferMultiplicity

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