estrutura DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES (dxgiddi.h)

Artigo
02/29/2024

Usado pelo driver de exibição do modo de usuário para especificar atributos de plano de sobreposição.

Sintaxe

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;

Membros

Flags

Especifica uma operação de inversão como um dos valores aplicáveis na enumeração DXGI_DDI_MULTIPLANE_OVERLAY_FLAGS .

SrcRect

Especifica o retângulo de origem, do tipo RECT, em relação ao recurso de origem.

DstRect

Especifica o retângulo de destino, do tipo RECT, em relação à resolução do monitor.

ClipRect

Especifica qualquer recorte adicional, do tipo RECT, em relação ao retângulo DstRect , depois que os dados forem estendidos de acordo com os valores de SrcRect e DstRect.

O driver e o hardware podem usar o membro ClipRect para aplicar um fator de alongamento comum, pois o recorte muda quando um aplicativo oclui parte do retângulo de destino DstRect .

Rotation

Especifica a rotação no sentido horário do plano de sobreposição, dado como um valor da enumeração DXGI_DDI_MODE_ROTATION .

Blend

Especifica o modo de combinação que se aplica a esse plano de sobreposição e ao plano abaixo dele, dado como um valor da enumeração DXGI_DDI_MULTIPLANE_OVERLAY_BLEND .

DirtyRectCount

O número de retângulos sujo especificados para o plano de sobreposição. Se zero, todo o plano será considerado sujo.

pDirtyRects

Um ponteiro para uma matriz de retângulos sujo (RECTs), em relação ao SrcRect do retângulo de origem, que indica a parte do plano de sobreposição que foi alterada.

O driver pode usar esse membro para executar otimizações, embora não seja necessário usar as informações do retângulo sujo. No entanto, o driver nunca deve falhar em uma chamada de função com base nos retângulos sujo fornecidos.

NumFilters

Opcionalmente, especifica o número de filtros que o driver e o hardware implementam no plano de sobreposição. Observe que o sistema operacional ignora esse membro.

pFilters

Um ponteiro opcional para um buffer que especifica os filtros que o driver e o hardware implementam no plano de sobreposição. Observe que o sistema operacional ignora esse membro.

VideoFrameFormat

Especifica o formato de quadro de vídeo do plano de sobreposição, dado como um valor da enumeração DXGI_DDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT .

Nota Esse valor sempre deve ser DXGI_DDI_MULIIPLANE_OVERLAY_VIDEO_FRAME_FORMAT_PROGRESSIVE. O sistema operacional não dá suporte aos outros valores de enumeração.

YCbCrFlags

Especifica informações de conversão e intervalo YUV como um dos valores aplicáveis na enumeração DXGI_DDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS .

StereoFormat

Especifica o formato de quadro de vídeo do plano de sobreposição, dado como um valor da enumeração DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FORMAT .

Nota Esse valor sempre deve ser DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FORMAT_MONO. O sistema operacional não dá suporte aos outros valores de enumeração.

StereoLeftViewFrame0

Reservado para uso do sistema. Deve ser sempre FALSE.

StereoBaseViewFrame0

Reservado para uso do sistema. Deve ser sempre FALSE.

StereoFlipMode

Especifica o modo de inversão estéreo do plano de sobreposição, dado como um valor da enumeração DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE .

Nota Esse valor sempre deve ser DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FLIP_NONE. O sistema operacional não dá suporte aos outros valores de enumeração.

StretchQuality

Especifica a qualidade de alongamento do plano de sobreposição, dada como um valor da enumeração DXGI_DDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY .