estructura DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES (dxgiddi.h)

Artículo
08/07/2023

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

Sintaxis

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;

Miembros

Flags

Especifica una operación de volteo como uno de los valores aplicables en la enumeración DXGI_DDI_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, relativo al 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 extendido 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 sentido de las agujas del reloj del plano de superposición, dado como un valor de la enumeración DXGI_DDI_MODE_ROTATION .

Blend

Especifica el modo de combinación que se aplica a este plano de superposición y al plano debajo de él, dado como un valor de la enumeración DXGI_DDI_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 el controlador y el hardware implementan 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 fotogramas de vídeo del plano de superposición, dado como un valor de la enumeración DXGI_DDI_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 como uno de los valores aplicables en la enumeración DXGI_DDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS .

StereoFormat

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

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

StereoLeftViewFrame0

Reservado para uso del sistema. Siempre debe ser FALSE.

StereoBaseViewFrame0

Reservado para uso del sistema. Siempre debe ser FALSE.

StereoFlipMode

Especifica el modo de volteo estéreo del plano de superposición, dado como un valor de la enumeración DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE .

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

StretchQuality

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