DXGI_DDI_ARG_PRESENT1 structure (dxgiddi.h)
Describes a resource to display. Used with the pfnPresent1(DXGI) function by Windows Display Driver Model (WDDM) 1.3 and later user-mode display drivers.
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;
[in] hDevice
A handle to the display device (graphics context) on which the driver performs the presentation. The Direct3D runtime passes this handle to the driver in the hDrvDevice member of the D3D10DDIARG_CREATEDEVICE structure when the runtime calls the driver's CreateDevice(D3D10) function to create the display device.
[in] phSurfacesToPresent
An array of non-NULL handles and zero-based indices to the source resource to display or to release. phSurfacesToPresent is always a valid handle for a resource to display.
[in] SurfacesToPresent
The array of surfaces to be presented. Must not be zero.
[in] hDstResource
A handle to the destination resource to display to. hDstResource can be NULL if the destination is unknown; kernel mode will determine the destination just before sending the hardware command stream through DMA to the graphics processor.
When many resource are being presented, hDstResource will be NULL, and the driver must only translate the last source resource handle for use with the pfnPresentCb function.
[in] DstSubResourceIndex
The zero-based index into the destination resource, which the handle in the hDstResource member specifies. The DstSubResourceIndex index indicates the subresource or surface to display to.
[in] pDXGIContext
A handle to the DXGI context. This handle is opaque to the driver. The driver must pass the handle in this member as the pDXGIContext member of the DXGIDDICB_PRESENT structure when the driver calls the pfnPresentCbDXGI function.
[in] Flags
A DXGI_DDI_PRESENT_FLAGS structure that identifies, in bit-field flags, how to perform the present operation.
[in] FlipInterval
A DXGI_DDI_FLIP_INTERVAL_TYPE-typed value that indicates the flip interval (that is, if the flip occurs after zero, one, two, three, or four vertical syncs).
Reserved
This member is reserved and should be set to zero.
[in] pDirtyRects
A pointer to an array of dirty rectangles (RECTs), relative to the source rectangle SrcRect, that indicate the portion of the overlay plane that has changed.
The driver can use this member to perform optimizations, though it's not required to use the dirty rectangle info. However, the driver should never fail a function call based on the provided dirty rectangles.
[in] DirtyRects
The number of dirty rectangles in the array pointed to by pDirtyRects.
BackBufferMultiplicity
The number of physical back buffer per logical back buffer.
Requirement | Value |
---|---|
Minimum supported client | Windows 8.1,WDDM 1.3 and later |
Minimum supported server | Windows Server 2012 R2 |
Header | dxgiddi.h (include D3d10umddi.h) |