estrutura D3DDDI_MULTIPLANE_OVERLAY_ATTRIBUTES (d3dumddi.h)

Artigo
08/07/2023

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

Sintaxe

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;

Membros

Flags

Especifica uma operação de inversão como um dos valores aplicáveis na enumeração D3DDDI_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 D3DDDI_ROTATION .

Blend

Especifica o modo de mesclagem que se aplica a esse plano de sobreposição e ao plano abaixo dele, dado como um valor da enumeração D3DDDI_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, fornecido como um valor da enumeração D3DDDI_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 fornecidas como um valor da enumeração D3DDDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS .

StretchQuality

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