DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY struttura (dxgiddi.h)

Articolo
08/07/2023

Descrive le allocazioni di sovrimpressione multipla copiate da e verso 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;

Members

[in] pDXGIContext

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

[in] hContext

Handle al contesto in cui il driver invia l'operazione di copia. Il driver di visualizzazione in modalità utente 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 capovolgimento. Per trasmettere un'operazione di capovolgimento, il driver miniport visualizzato deve supportare i capovolgimenti basati su I/O (MMIO) mappati alla memoria. Per indicare il supporto delle capovolgimenti MMIO, il driver miniport visualizzato imposta il flag di campo a bit FlipOnVSyncMmIo nel membro FlipCaps 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 presenta 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 presente al contesto di proprietà (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 sovrapposizione multipla.