struttura DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY (dxgiddi.h)

Articolo
02/06/2025

Descrive le allocazioni di sovrimpressione multipla da cui viene copiato il contenuto.

Sintassi

typedef struct DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY {
  [in] void                                       *pDXGIContext;
  [in] HANDLE                                     hContext;
  [in] UINT                                       BroadcastContextCount;
       HANDLE                                     BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
  [in] DWORD                                      AllocationInfoCount;
       DXGIDDI_MULTIPLANE_OVERLAY_ALLOCATION_INFO AllocationInfo[DXGI_DDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS];
} DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY;

Membri

[in] pDXGIContext

Handle per il contesto DXGI (Microsoft DirectX Graphics Infrastructure). Questo handle è opaco per il driver. Il driver deve assegnare l'handle dal membro pDXGIContext della struttura DXGI_DDI_ARG_PRESENTMULTIPLANEOVERLAY ricevuta dal driver in una chiamata al relativo pfnPresentMultiplaneOverlay (DXGI) funzione a questo membro.

[in] hContext

Handle al contesto a cui il driver invia l'operazione di copia. Il driver di visualizzazione in modalità utente ha creato in precedenza questo contesto chiamando la funzione pfnCreateContextCb.

[in] BroadcastContextCount

Numero di contesti aggiuntivi nella matrice specificata dal membro BroadcastContext.

[in] BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

Matrice di handle per i contesti aggiuntivi a cui trasmettere l'operazione corrente. La costante D3DDDI_MAX_BROADCAST_CONTEXT, definita come 64, definisce il numero massimo di contesti aggiuntivi a cui il driver di visualizzazione in modalità utente può trasmettere l'operazione corrente.

La trasmissione è supportata solo per le operazioni di scorrimento. Per trasmettere un'operazione di scorrimento, il driver miniport di visualizzazione deve supportare i capovolgimenti basati su I/O mappati alla memoria (MMIO). Per indicare il supporto dei capovolgimenti MMIO, il driver miniport di visualizzazione imposta il flag FlipOnVSyncMmIo flag di campo di bit nel FlipCaps membro della struttura DXGK_DRIVERCAPS quando viene chiamata la funzione DxgkDdiQueryAdapterInfo.

Il contesto originale specificato dal membro hContext e che il driver di visualizzazione in modalità utente non è un elemento nella matrice BroadcastContext. Ad esempio, se la matrice BroadcastContext contiene un elemento, il driver di visualizzazione in modalità utente invia l'operazione corrente al contesto proprietario (hContext) e trasmette a tale contesto aggiuntivo.

[in] AllocationInfoCount

Numero di allocazioni nella matrice specificata dal membro AllocationInfo. Il numero massimo è 16, il valore della costante DXGI_DDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS.

AllocationInfo[DXGI_DDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS]

Matrice di strutture di tipo DXGIDDI_MULTIPLANE_OVERLAY_ALLOCATION_INFO che specificano informazioni sulle allocazioni di sovrimpressione multipla.