Edit

Share via

DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS enumeration (dxgiddi.h)

  • Article

Identifies overlay capabilities.

Syntax

typedef enum DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS {
  DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_ROTATION_WITHOUT_INDEPENDENT_FLIP,
  DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_VERTICAL_FLIP,
  DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_HORIZONTAL_FLIP,
  DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_DEINTERLACE,
  DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_STEREO,
  DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_RGB,
  DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_YUV,
  DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_BILINEAR_FILTER,
  DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_HIGH_FILTER,
  DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_ROTATION,
  DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_FULLSCREEN_POST_COMPOSITION,
  DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_RESERVED1,
  DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_SHARED,
  DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_IMMEDIATE,
  DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_PLANE0_FOR_VIRTUAL_MODE_ONLY
} ;

Constants

 
DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_ROTATION_WITHOUT_INDEPENDENT_FLIP
DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_VERTICAL_FLIP
The overlay plane can flip the data vertically, making it appear upside-down.
DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_HORIZONTAL_FLIP
The overlay plane can flip the data horizontally, making it appear as a right-to-left mirror image.
DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_DEINTERLACE
Reserved for system use. The user-mode display driver should not use this value.
DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_STEREO
Reserved for system use. The user-mode display driver should not use this value.
DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_RGB
DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_YUV
DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_BILINEAR_FILTER
Can do bilinear stretching.
DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_HIGH_FILTER
Can do better than bilinear stretching.
DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_ROTATION
The overlay plane can rotate the data 90, 180, and 270 degrees.
DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_FULLSCREEN_POST_COMPOSITION
Indicates that the caps reported in this group apply to a fullscreen plane and that all operation applied to this plane occur after composition with other MPO planes has occurred. This is useful for the following scenarios:

* Panel fitter HW can be employed to stretch the surface to match the screen. This is useful for supporting virtual modes.

* It can stretch or shrink the desktop plane for the VidPnSourceId to match of a single monitor with the following limitations:

* The entire allocation must be stretched – no sub rectangles are supported.
* This must be plane 0 in the Z order.

* If a HW cursor is supported, the HW cursor will get composed with the desktop plane prior to the stretching (i.e. the HW cursor will get stretched or shrunk with the rest of the desktop plane).
* If other MPO planes are supported in addition to the panel fitter, the clip rectangles for the other MPO planes are bound to the source rect of the panel fitter plane.

* In HDR scenarios, the presenting the HDR allocation (potentially with metadata) will just look like an MPO present with a single plane that covers the entire screen.

This flag should not be reported in the same capability groups as normal MPO.
DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_RESERVED1
DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_SHARED
Indicates that the hardware described in this capability group could be shared across outputs.

For example, if hardware supports a dedicated panel fitter per output, but also supports 4 additional MPO planes that are shared across multiple outputs, the driver would report the following capability groups on each output:

* One capability group for the panel fitter that does not set the DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_SHARED capability flag.
* One or more capability groups describing the 4 MPO planes that do set the DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_SHARED capability.
DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_IMMEDIATE
Indicates that the HW supports immediate flips of the MPO plane as long as the only change is the display start address.
DXGI_DDI_MULTIPLANE_OVERLAY_FEATURE_CAPS_PLANE0_FOR_VIRTUAL_MODE_ONLY
Indicates that stretching/shrinking of plane 0 should only occur when plane 0 is the desktop plane and the stretching/shrinking is used for virtual mode support.

Requirements

Requirement Value
Minimum supported client Windows 8.1
Minimum supported server Windows Server 2012 R2
Header dxgiddi.h (include D3d10umddi.h)