structure DXGK_MULTIPLANE_OVERLAY_PLANE3 (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 64 bits par plan utilisé par le pilote pour signaler l’achèvement de la commande de superposition.

InputFlags

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

OutputFlags

Structure DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS contenant l’état retourné par le pilote.

MaxImmediateFlipLine

Ligne d’affichage délimitant si un retournement VSYNC doit être promu vers un retour 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 retour VSYNC vers un retour immédiat n’est pas souhaitée. Dans ce cas, le retournement attend toujours le prochain VSYNC.

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

La valeur de 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 retour VSYNC est promu à un retour immédiat, le pilote doit définir DXGK_PLANE_SPECIFIC_OUTPUT_FLAGS. FlipConvertedToImmediate sur TRUE.

ContextCount

Nombre de contextes dans le tableau spécifié par le membre Context.

ppContextData

Tableau de handles aux 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.

Exigences

Exigence	Valeur
d’en-tête	d3dkmddi.h