structure D3DDDICB_PRESENTMULTIPLANEOVERLAY (d3dumddi.h)

Article
02/06/2025

Décrit les allocations de superposition multiplane à partir de laquelle le contenu est copié.

Syntaxe

typedef struct D3DDDICB_PRESENTMULTIPLANEOVERLAY {
  [in] HANDLE                            hContext;
  [in] UINT                              BroadcastContextCount;
       HANDLE                            BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
  [in] UINT                              AllocationInfoCount;
       D3DDDI_MULTIPLANE_ALLOCATION_INFO AllocationInfo[D3DDDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS];
} D3DDDICB_PRESENTMULTIPLANEOVERLAY;

Membres

[in] hContext

Handle vers le contexte auquel le pilote envoie l’opération de copie. Le pilote d’affichage en mode utilisateur a créé ce contexte précédemment en appelant la fonction pfnCreateContextCb.

[in] BroadcastContextCount

Nombre de contextes supplémentaires dans le tableau spécifié par le membre BroadcastContext.

[in] BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

Tableau de handles vers les contextes supplémentaires pour diffuser l’opération actuelle vers. La constante D3DDDI_MAX_BROADCAST_CONTEXT, définie comme 64, définit le nombre maximal de contextes supplémentaires vers lesquels le pilote d’affichage en mode utilisateur peut diffuser l’opération actuelle.

La diffusion est prise en charge uniquement pour les opérations de retournement. Pour diffuser une opération de retournement, le pilote miniport d’affichage doit prendre en charge les flips basés sur les E/S mappés en mémoire (MMIO). Pour indiquer la prise en charge des retournements MMIO, le pilote miniport d’affichage définit l’indicateur FlipOnVSyncMmIo dans le Membre flipCaps de la structure de DXGK_DRIVERCAPS lorsque sa fonction DxgkDdiQueryAdapterInfo est appelée.

Contexte d’origine auquel le membre hContext spécifie et que le pilote d’affichage en mode utilisateur présente n’est pas un élément dans le tableau BroadcastContext. Par exemple, si le tableau BroadcastContext contient un élément, le pilote d’affichage en mode utilisateur envoie l’opération actuelle au contexte propriétaire (hContext) et diffuse à ce contexte supplémentaire.

[in] AllocationInfoCount

Nombre d’allocations dans le tableau que le membre AllocationInfo spécifie. Le nombre maximal est 16, la valeur de la constante D3DDDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS.

AllocationInfo[D3DDDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS]

Tableau de structures de type D3DDDI_MULTIPLANE_ALLOCATION_INFO qui spécifient des informations sur les allocations de superposition multiplane.