DXGK_MULTIPLANE_OVERLAY_PLANE3 structure (d3dkmddi.h)

Spécifie un plan de superposition à afficher dans un appel à la fonction DxgkDdiSetVidPnSourceAddressWithMultiPlaneOverlay3 .

Syntaxe

typedef struct _DXGK_MULTIPLANE_OVERLAY_PLANE3 {
  UINT                                LayerIndex;
  ULONGLONG                           PresentId;
  DXGK_PLANE_SPECIFIC_INPUT_FLAGS     InputFlags;
  DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS    OutputFlags;
  UINT                                MaxImmediateFlipLine;
  UINT                                ContextCount;
  DXGK_PRIMARYCONTEXTDATA             **ppContextData;
  UINT                                DriverPrivateDataSize;
  PVOID                               pDriverPrivateData;
  DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 PlaneAttributes;
} DXGK_MULTIPLANE_OVERLAY_PLANE3;

Membres

LayerIndex

Index de base zéro du plan de superposition à afficher. Le plan supérieur (dans la direction z) a l’index zéro. Les valeurs d’index des plans doivent être séquentielles de haut en bas.

PresentId

Identificateur de plan 64 bits utilisé par le pilote pour signaler l’achèvement de la commande de superposition.

InputFlags

Structure DXGK_PLANE_SPECIFIC_INPUT_FLAGS qui identifie toutes les opérations d’affichage spécifiques au plan à effectuer.

OutputFlags

Structure DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS contenant status retournée par le pilote.

MaxImmediateFlipLine

Ligne d’affichage indiquant si un retournement VSYNC doit être promu en retournement immédiat, où la ligne 0 correspond au premier pixel actif du cadre. Cette valeur est ignorée pour les retournements non VSYNC.

Cette valeur est -1 lorsque la promotion d’un basculement VSYNC vers un retournement immédiat n’est pas souhaitée. Dans ce cas, le basculement attend toujours le prochain VSYNC.

Pour une valeur autre que -1, le pilote doit promouvoir ce retournement en retournement immédiat si le HW n’a pas encore commencé à lire à partir de la ligne d’affichage spécifiée. Les valeurs 0 peuvent être promues en retournements immédiats si le HW a bloqué des registres pour l’image d’affichage actuelle, mais n’a pas encore commencé à analyser le premier pixel actif.

La valeur de la ligne d’affichage est relative au mode physique défini. Si l’affichage effectue une mise à l’échelle, la ligne d’affichage est relative à la taille après l’application de la mise à l’échelle.

Lorsqu’un basculement VSYNC est promu en retournement immédiat, le pilote doit définir DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS. Retournez La valeur TRUE à l’objet FlipConvertedToImmediate.

ContextCount

Nombre de contextes dans le tableau que le membre Context spécifie.

ppContextData

Tableau de handles pour les contextes qui ont contribué à une opération d’affichage.

DriverPrivateDataSize

Taille des données du pilote privé.

pDriverPrivateData

Données de pilote privé.

PlaneAttributes

Structure de type DXGK_MULTIPLANE_OVERLAY_ATTRIBUTES3 qui spécifie les attributs de plan de superposition.

Configuration requise

Condition requise	Valeur
En-tête	d3dkmddi.h