estructura D3DDDI_MULTIPLANE_OVERLAY_ATTRIBUTES (d3dumddi.h)

Artículo
08/07/2023

Usado por el controlador de pantalla en modo de usuario para especificar los atributos del plano de superposición.

Sintaxis

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;

Miembros

Flags

Especifica una operación de volteo como uno de los valores aplicables en la enumeración D3DDDI_MULTIPLANE_OVERLAY_FLAGS .

SrcRect

Especifica el rectángulo de origen, de tipo RECT, en relación con el recurso de origen.

DstRect

Especifica el rectángulo de destino, de tipo RECT, en relación con la resolución del monitor.

ClipRect

Especifica cualquier recorte adicional, de tipo RECT, en relación con el rectángulo DstRect , después de que los datos se hayan extendido según los valores de SrcRect y DstRect.

El controlador y el hardware pueden usar el miembro ClipRect para aplicar un factor de extensión común a medida que cambia el recorte cuando una aplicación ocluye parte del rectángulo de destino DstRect .

Rotation

Especifica el giro en el sentido de las agujas del reloj del plano de superposición, dado como un valor de la enumeración D3DDDI_ROTATION .

Blend

Especifica el modo de mezcla que se aplica a este plano de superposición y el plano debajo de él, dado como un valor de la enumeración D3DDDI_MULTIPLANE_OVERLAY_BLEND .

DirtyRectCount

Número de rectángulos sucios especificados para el plano de superposición. Si es cero, todo el plano se considera sucio.

pDirtyRects

Puntero a una matriz de rectángulos sucios (RECTs), en relación con el rectángulo de origen SrcRect, que indica la parte del plano de superposición que ha cambiado.

El controlador puede usar este miembro para realizar optimizaciones, aunque no es necesario usar la información de rectángulo sucio. Sin embargo, el controlador nunca debe producir un error en una llamada de función basada en los rectángulos sucios proporcionados.

NumFilters

Opcionalmente, especifica el número de filtros que implementa el controlador y el hardware en el plano de superposición. Tenga en cuenta que el sistema operativo omite este miembro.

pFilters

Puntero opcional a un búfer que especifica los filtros que el controlador y el hardware implementan en el plano de superposición. Tenga en cuenta que el sistema operativo omite este miembro.

VideoFrameFormat

Especifica el formato de fotograma de vídeo del plano de superposición, dado como un valor de la enumeración D3DDDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT .

Nota Este valor siempre debe ser DXGI_DDI_MULIIPLANE_OVERLAY_VIDEO_FRAME_FORMAT_PROGRESSIVE. El sistema operativo no admite los demás valores de enumeración.

YCbCrFlags

Especifica el intervalo YUV y la información de conversión proporcionados como un valor de la enumeración D3DDDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS .

StretchQuality

Especifica la calidad de ajuste del plano de superposición, dada como un valor de la enumeración D3DDDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY .