structure D3DDDI_MULTIPLANE_OVERLAY_ATTRIBUTES (d3dumddi.h)

Article
02/06/2025

Utilisé par le pilote d’affichage en mode utilisateur pour spécifier des attributs de plan de superposition.

Syntaxe

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;

Membres

Flags

Spécifie une opération de retournement comme l’une des valeurs applicables dans l’énumération D3DDDI_MULTIPLANE_OVERLAY_FLAGS.

SrcRect

Spécifie le rectangle source, de type RECT, par rapport à la ressource source.

DstRect

Spécifie le rectangle de destination, de type RECT, par rapport à la résolution du moniteur.

ClipRect

Spécifie tout découpage supplémentaire, de type RECT, par rapport au rectangle DstRect, une fois que les données ont été étirées en fonction des valeurs de SrcRect et DstRect.

Le pilote et le matériel peuvent utiliser le membre ClipRect pour appliquer un facteur d’étirement commun lorsque l’application change lorsqu’une application fait partie du rectangle de destination DstRect.

Rotation

Spécifie la rotation au niveau de l’horloge du plan de superposition, donnée sous forme de valeur de l’énumération D3DDDI_ROTATION.

Blend

Spécifie le mode de fusion qui s’applique à ce plan de superposition et le plan sous celui-ci, donné sous la forme d’une valeur de l’énumération D3DDDI_MULTIPLANE_OVERLAY_BLEND.

DirtyRectCount

Nombre de rectangles sales spécifiés pour le plan de superposition. Si zéro, l’ensemble du plan est considéré comme sale.

pDirtyRects

Pointeur vers un tableau de rectangles sales (RECTs), par rapport au rectangle source SrcRect, qui indiquent la partie du plan de superposition qui a changé.

Le pilote peut utiliser ce membre pour effectuer des optimisations, mais il n’est pas nécessaire d’utiliser les informations de rectangle sale. Toutefois, le pilote ne doit jamais échouer un appel de fonction en fonction des rectangles incorrects fournis.

NumFilters

Spécifie éventuellement le nombre de filtres que le pilote et le matériel implémentent sur le plan de superposition. Notez que le système d’exploitation ignore ce membre.

pFilters

Pointeur facultatif vers une mémoire tampon qui spécifie les filtres que le pilote et le matériel implémentent sur le plan de superposition. Notez que le système d’exploitation ignore ce membre.

VideoFrameFormat

Spécifie le format de trame vidéo du plan de superposition, donné sous forme de valeur de l’énumération D3DDDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT.

Remarque Cette valeur doit toujours être DXGI_DDI_MULIIPLANE_OVERLAY_VIDEO_FRAME_FORMAT_PROGRESSIVE. Le système d’exploitation ne prend pas en charge les autres valeurs d’énumération.

YCbCrFlags

Spécifie les informations de conversion et de plage YUV fournies sous la forme d’une valeur de l’énumération D3DDDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS.

StretchQuality

Spécifie la qualité d’étirement du plan de superposition, donnée sous la forme d’une valeur de l’énumération D3DDDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY.