D3DDDI_MULTIPLANE_OVERLAY_ATTRIBUTES estrutura (d3dumddi.h)

Artigo
02/06/2025

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, relativo ao retângulo de DstRect, depois que os dados tiverem sido estendidos de acordo com os valores de SrcRect e DstRect.

O driver e o hardware podem usar o membro cliprect do para aplicar um fator de alongamento comum à medida que o recorte é alterado quando um aplicativo oclui parte do retângulo de destino do 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 sujos especificados para o plano de sobreposição. Se zero, o avião inteiro é considerado sujo.

pDirtyRects

Um ponteiro para uma matriz de retângulos sujos (de RECT), em relação ao retângulo de origem SrcRect, que indicam 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 de retângulo sujo. No entanto, o driver nunca deve falhar em uma chamada de função com base nos retângulos sujos 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 D3DDDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT.

Observação 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 da extensão do plano de sobreposição, dada como um valor da enumeração D3DDDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY.