structure DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES (dxgiddi.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 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;

Membres

Flags

Spécifie une opération de retournement comme l’une des valeurs applicables dans l’énumération DXGI_DDI_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 DXGI_DDI_MODE_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 DXGI_DDI_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 DXGI_DDI_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 plage et de conversion YUV comme une des valeurs applicables dans l’énumération DXGI_DDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS.

StereoFormat

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

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

StereoLeftViewFrame0

Réservé à l’utilisation du système. Doit toujours être FALSE.

StereoBaseViewFrame0

Réservé à l’utilisation du système. Doit toujours être FALSE.

StereoFlipMode

Spécifie le mode de retournement stéréo du plan de superposition, donné sous la forme d’une valeur de l’énumération DXGI_DDI_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE.

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

StretchQuality

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