structure DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES (d3dkmddi.h)

Article
02/06/2025

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

Syntaxe

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;

Membres

Flags

Spécifie une opération de retournement comme l’une des valeurs constantes applicables dans l’énumération DXGK_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 DXGK_MULTIPLANE_OVERLAY_BLEND.

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

Remarque Cette valeur doit toujours être DXGK_MULTIPLANE_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 fournies sous la forme d’une valeur de l’énumération DXGK_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 DXGK_MULTIPLANE_OVERLAY_STEREO_FORMAT.

Remarque Cette valeur doit toujours être DXGK_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 DXGK_MULTIPLANE_OVERLAY_STEREO_FLIP_MODE.

Remarque Cette valeur doit toujours être DXGK_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 forme de valeur de l’énumération DXGK_MULTIPLANE_OVERLAY_STRETCH_QUALITY.