estrutura DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES (dxgiddi.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 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, 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 DXGI_DDI_MODE_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 DXGI_DDI_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 DXGI_DDI_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 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, fornecido como um valor da enumeração DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FORMAT.

Observação 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.

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

StretchQuality

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