structure DXGI_DDI_ARG_PRESENT1 (dxgiddi.h)
Décrit une ressource à afficher. Utilisé avec la fonction pfnPresent1(DXGI) par le modèle de pilote d’affichage Windows (WDDM) 1.3 et versions ultérieures.
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 de l’appareil d’affichage (contexte graphique) sur lequel le pilote effectue la présentation. Le runtime Direct3D transmet ce handle au pilote dans le hDrvDevice membre de la structure D3D10DDIARG_CREATEDEVICE lorsque le runtime appelle la fonction CreateDevice(D3D10) du pilote pour créer l’appareil d’affichage.
[in] phSurfacesToPresent
Tableau d’index null non-NULL et d’index de base zéro à la ressource source à afficher ou à libérer. phSurfacesToPresent est toujours un handle valide pour qu’une ressource s’affiche.
[in] SurfacesToPresent
Tableau de surfaces à présenter. Ne doit pas être zéro.
[in] hDstResource
Handle vers 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ériel via DMA au processeur graphique.
Lorsque de nombreuses ressources sont présentées, hDstResource sera NULL, et le pilote ne doit traduire que le dernier handle de ressource source à utiliser avec la fonction pfnPresentCb.
[in] DstSubResourceIndex
Index de base zéro dans la ressource de destination, que le handle dans le hDstResource membre spécifie. L’index DstSubResourceIndex indique la sous-ressource ou la surface à afficher.
[in] pDXGIContext
Handle du contexte DXGI. Ce handle est opaque pour le pilote. Le pilote doit passer le handle dans ce membre en tant que membre pDXGIContext membre 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 DXGI_DDI_FLIP_INTERVAL_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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8.1,WDDM 1.3 et versions ultérieures |
| serveur minimum pris en charge | Windows Server 2012 R2 |
| d’en-tête | dxgiddi.h (include D3d10umddi.h) |