структура DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES (dxgiddi.h)

Статья
08/07/2023

Используется драйвером отображения пользовательского режима для указания атрибутов плоскости наложения.

Синтаксис

typedef struct DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES {
  UINT                                           Flags;
  RECT                                           SrcRect;
  RECT                                           DstRect;
  RECT                                           ClipRect;
  DXGI_DDI_MODE_ROTATION                         Rotation;
  DXGI_DDI_MULTIPLANE_OVERLAY_BLEND              Blend;
  UINT                                           DirtyRectCount;
  RECT                                           *pDirtyRects;
  UINT                                           NumFilters;
  void                                           *pFilters;
  DXGI_DDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT VideoFrameFormat;
  UINT                                           YCbCrFlags;
  DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FORMAT      StereoFormat;
  BOOL                                           StereoLeftViewFrame0;
  BOOL                                           StereoBaseViewFrame0;
  DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE   StereoFlipMode;
  DXGI_DDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY    StretchQuality;
} DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES;

Члены

Flags

Указывает операцию переверки в качестве одного из применимых значений в перечислении DXGI_DDI_MULTIPLANE_OVERLAY_FLAGS.

SrcRect

Указывает исходный прямоугольник типа RECTотносительно исходного ресурса.

DstRect

Задает прямоугольник назначения типа RECTотносительно разрешения монитора.

ClipRect

Указывает любое дополнительное вырезка типа RECTотносительно прямоугольника DstRect после растягивания данных в соответствии со значениями SrcRect и DstRect.

Драйвер и оборудование могут использовать элемент ClipRect, чтобы применить общий коэффициент растяжения в качестве обрезки изменений, когда приложение occludes часть DstRect целевом прямоугольнике.

Rotation

Задает поворот по часовой стрелке плоскости наложения, заданный как значение из перечисления DXGI_DDI_MODE_ROTATION.

Blend

Указывает режим смешивания, который применяется к этому плоскости наложения и плоскости под ним, заданному как значение из перечисления DXGI_DDI_MULTIPLANE_OVERLAY_BLEND.

DirtyRectCount

Количество грязных прямоугольников, указанных для плоскости наложения. Если ноль, весь самолет считается грязным.

pDirtyRects

Указатель на массив грязных прямоугольников (RECTs), относительно исходного прямоугольника SrcRect, указывающий часть плоскости наложения, которая изменилась.

Драйвер может использовать этот элемент для оптимизации, хотя не требуется использовать грязные данные прямоугольника. Однако драйвер никогда не должен завершать вызов функции на основе предоставленных грязных прямоугольников.

NumFilters

При необходимости указывает количество фильтров, реализуемых драйвером и оборудованием на плоскости наложения. Обратите внимание, что операционная система игнорирует этот элемент.

pFilters

Необязательный указатель на буфер, указывающий фильтры, которые драйвер и оборудование реализуют на плоскости наложения. Обратите внимание, что операционная система игнорирует этот элемент.

VideoFrameFormat

Задает формат видеокадров плоскости наложения, заданный в качестве значения из перечисления DXGI_DDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT.

Примечание Это значение всегда должно быть DXGI_DDI_MULIIPLANE_OVERLAY_VIDEO_FRAME_FORMAT_PROGRESSIVE. Операционная система не поддерживает другие значения перечисления.

YCbCrFlags

Задает сведения о диапазоне и преобразовании YUV в качестве одного из применимых значений в перечислении DXGI_DDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS.

StereoFormat

Задает формат видеокадров плоскости наложения, заданный в качестве значения из перечисления DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FORMAT.

примечание Это значение всегда должно быть DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FORMAT_MONO. Операционная система не поддерживает другие значения перечисления.

StereoLeftViewFrame0

Зарезервировано для использования системы. Всегда должен быть false.

StereoBaseViewFrame0

Зарезервировано для использования системы. Всегда должен быть false.

StereoFlipMode

Задает режим стереолиста плоскости наложения, заданный как значение из перечисления DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE.

Примечание Это значение всегда должно быть DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FLIP_NONE. Операционная система не поддерживает другие значения перечисления.

StretchQuality

Указывает качество растяжения плоскости наложения, заданное как значение из перечисления DXGI_DDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8.1
минимальный поддерживаемый сервер	Windows Server 2012 R2
заголовка	dxgiddi.h (include D3d10umddi.h)