estrutura DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES (d3dkmddi.h)

Artigo
02/06/2025

Usado pelo driver de miniporto de exibição para especificar atributos de plano de sobreposição.

Sintaxe

typedef struct _DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES {
  DXGK_MULTIPLANE_OVERLAY_FLAGS              Flags;
  RECT                                       SrcRect;
  RECT                                       DstRect;
  RECT                                       ClipRect;
  D3DDDI_ROTATION                            Rotation;
  DXGK_MULTIPLANE_OVERLAY_BLEND              Blend;
  UINT                                       NumFilters;
  void                                       *pFilters;
  DXGK_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT VideoFrameFormat;
  DXGK_MULTIPLANE_OVERLAY_YCbCr_FLAGS        YCbCrFlags;
  DXGK_MULTIPLANE_OVERLAY_STEREO_FORMAT      StereoFormat;
  BOOL                                       StereoLeftViewFrame0;
  BOOL                                       StereoBaseViewFrame0;
  DXGK_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE   StereoFlipMode;
  DXGK_MULTIPLANE_OVERLAY_STRETCH_QUALITY    StretchQuality;
} DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES;

Membros

Flags

Especifica uma operação de inversão como um dos valores constantes aplicáveis na enumeração DXGK_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 mistura que se aplica a esse plano de sobreposição e ao plano abaixo dele, dado como um valor da enumeração DXGK_MULTIPLANE_OVERLAY_BLEND.

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 DXGK_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT.

Observação Esse valor sempre deve ser DXGK_MULTIPLANE_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 DXGK_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 DXGK_MULTIPLANE_OVERLAY_STEREO_FORMAT.

Observação Esse valor sempre deve ser DXGK_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 DXGK_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE.

Observação Esse valor sempre deve ser DXGK_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 DXGK_MULTIPLANE_OVERLAY_STRETCH_QUALITY.