structure D3DDDI_MULTIPLANE_OVERLAY_ATTRIBUTES (d3dumddi.h)

Article
08/07/2023

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, relatif 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 le découpage change lorsqu’une application obstrue une partie du rectangle de destination DstRect .

Rotation

Spécifie la rotation dans le sens des aiguilles d’une montre du plan de superposition, donnée en tant que valeur de l’énumération D3DDDI_ROTATION .

Blend

Spécifie le mode de fusion qui s’applique à ce plan de superposition et au plan situé sous celui-ci, donné en tant que valeur de l’énumération D3DDDI_MULTIPLANE_OVERLAY_BLEND .

DirtyRectCount

Nombre de rectangles sale spécifiés pour le plan de superposition. Si zéro, le plan entier est considéré comme sale.

pDirtyRects

Pointeur vers un tableau de rectangles sale (RECT), relatif au rectangle source SrcRect, qui indique la partie du plan de superposition qui a changé.

Le pilote peut utiliser ce membre pour effectuer des optimisations, bien qu’il ne soit pas nécessaire d’utiliser les informations de rectangle sale. Toutefois, le pilote ne doit jamais échouer un appel de fonction basé sur les rectangles sale 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 d’image vidéo du plan de superposition, donné en tant que valeur de l’énumération D3DDDI_MULTIPLANE_OVERLAY_VIDEO_FRAME_FORMAT .

Note 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 la plage YUV et les informations de conversion fournies en tant que valeur de l’énumération D3DDDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS .

StretchQuality

Spécifie la qualité d’étirement du plan de superposition, donnée en tant que valeur de l’énumération D3DDDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY .