структура 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 для применения общего коэффициента растяжения, так как обрезка изменяется, когда приложение включает часть прямоугольника назначения DstRect .

Rotation

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

Blend

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

DirtyRectCount

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

pDirtyRects

Указатель на массив грязное прямоугольников (RECT) относительно исходного прямоугольника 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 (включая D3d10umddi.h)