D3DDDIARG_PRESENT1 structure (d3dumddi.h)

Describes a resource to display. Used with the pfnPresent1(D3D) function by Windows Display Driver Model (WDDM) 1.3 and later user-mode display drivers.

Syntax

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;

Members

[in] phSrcResources

An array of non-NULL handles and zero-based indices to the source resource to display or to release. phSrcResources is always a valid handle for a resource to display.

[in] SrcResources

The number of source resources that are in the array pointed to by phSrcResources.

[in] hDstResource

A handle to the destination resource to display to. If NULL, the destination is unknown, and the display miniport driver determines the destination just before the hardware command stream is processed.

DstSubResourceIndex

[in] The zero-based index into the destination resource, which is specified by the handle in the hDstResource member. This index indicates the subresource or surface to display to.

[in] Flags

A D3DDDI_PRESENTFLAGS structure that identifies, in bit-field flags, how to display.

[in] FlipInterval

A D3DDDI_FLIPINTERVAL_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.

Requirements

See also

D3DDDI_FLIPINTERVAL_TYPE

D3DDDI_PRESENTFLAGS

RECT

pfnPresent1(D3D)

pfnPresentCb