структура D3DDDI_MULTIPLANE_OVERLAY_ATTRIBUTES (d3dumddi.h)

Статья
02/26/2024

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

Синтаксис

typedef struct _D3DDDI_MULTIPLANE_OVERLAY_ATTRIBUTES {
  UINT                                         Flags;
  RECT                                         SrcRect;
  RECT                                         DstRect;
  RECT                                         ClipRect;
  D3DDDI_ROTATION                              Rotation;
  D3DDDI_MULTIPLANE_OVERLAY_BLEND              Blend;
  UINT                                         DirtyRectCount;
  RECT                                         *pDirtyRects;
  UINT                                         NumFilters;
  void                                         *pFilters;
  D3DDDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT VideoFrameFormat;
  UINT                                         YCbCrFlags;
  D3DDDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY    StretchQuality;
} D3DDDI_MULTIPLANE_OVERLAY_ATTRIBUTES;

Члены

Flags

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

SrcRect

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

DstRect

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

ClipRect

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

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

Rotation

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

Blend

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

DirtyRectCount

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

pDirtyRects

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

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

NumFilters

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

pFilters

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

VideoFrameFormat

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

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

YCbCrFlags

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

StretchQuality

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 8.1
Минимальная версия сервера	Windows Server 2012 R2
Верхняя часть	d3dumddi.h (включая D3dumddi.h)