structure DXGI_DDI_MULTIPLANE_OVERLAY_ATTRIBUTES (dxgiddi.h)

Article
03/01/2024

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 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 sous la forme d’une 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 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), par rapport 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 DXGI_DDI_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 comme l’une des valeurs applicables dans l’énumération DXGI_DDI_MULTIPLANE_OVERLAY_YCbCr_FLAGS .

StereoFormat

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

Note 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é pour le système. Doit toujours être FALSE.

StereoBaseViewFrame0

Réservé pour le 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 .

Note 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 forme de valeur de l’énumération DXGI_DDI_MULTIPLANE_OVERLAY_STRETCH_QUALITY .