DXGK_DEVICEINFO struttura (d3dkmddi.h)

Articolo
02/23/2024

La struttura DXGK_DEVICEINFO descrive i parametri richiesti dal sottosistema kernel della grafica Microsoft DirectX dal driver miniport visualizzato.

Sintassi

typedef struct _DXGK_DEVICEINFO {
  [out] UINT                 DmaBufferSize;
  [out] UINT                 DmaBufferSegmentSet;
  [out] UINT                 DmaBufferPrivateDataSize;
  [out] UINT                 AllocationListSize;
  [out] UINT                 PatchLocationListSize;
  [out] DXGK_DEVICEINFOFLAGS Flags;
} DXGK_DEVICEINFO;

Members

[out] DmaBufferSize

Le dimensioni, in byte, del buffer dei comandi hardware inviati tramite l'accesso diretto alla memoria (DMA) all'hardware.

Il buffer DMA può aumentare e compattare dopo la creazione del dispositivo; tuttavia, il buffer DMA non può mai ridurre le dimensioni iniziali specificate da DmaBufferSize .

[out] DmaBufferSegmentSet

Gli identificatori dei segmenti in cui i buffer DMA devono essere resi accessibili all'unità di elaborazione grafica (GPU).

[out] DmaBufferPrivateDataSize

Dimensioni, in byte, della struttura di dati privati residenti nel driver associata a ogni buffer DMA. La memoria per questa struttura dati privata viene allocata dal pool non a pagina. Se il driver specifica zero in DmaBufferPrivateDataSize, non viene allocata alcuna memoria per la struttura dei dati privati.

La struttura di dati privata associata a un buffer DMA viene inizializzata su zero quando viene creato il buffer DMA. Durante la durata del buffer DMA, la gestione memoria video non accede mai alla struttura di dati privata associata al buffer DMA.

[out] AllocationListSize

Numero iniziale di elementi in una matrice di allocazioni, ovvero una matrice di strutture DXGK_ALLOCATIONLIST . Questo numero è il numero iniziale di allocazioni che il driver richiede di trovarsi nei membri pAllocationList di DXGKARG_PRESENT e DXGKARG_RENDER strutture nelle chiamate alle funzioni DxgkDdiPresent e DxgkDdiRender.

L'elenco di allocazione può aumentare e compattare dopo la creazione del dispositivo; Tuttavia, l'elenco di allocazione non può mai ridurre le dimensioni iniziali specificate da AllocationListSize .

[out] PatchLocationListSize

Numero iniziale di elementi in una matrice di posizioni delle patch, ovvero una matrice di strutture D3DDDI_PATCHLOCATIONLIST , per il dispositivo in modalità utente e in modalità kernel. Questo numero è il numero iniziale di percorsi di patch che il driver richiede di trovarsi nei membri pPatchLocationListIn delle strutture di DXGKARG_RENDER nelle chiamate alla funzione DxgkDdiRender .

L'elenco di patch-location può aumentare e compattare dopo la creazione del dispositivo; Tuttavia, l'elenco di patch-location non può mai ridurre le dimensioni iniziali specificate da PatchLocationListSize .

[out] Flags

Struttura DXGK_DEVICEINFOFLAGS che identifica, in flag di campo a bit, informazioni sul dispositivo.

Commenti

Il driver miniport visualizzato specifica i valori per i membri DmaBufferSize e AllocationListSize per garantire quanto segue:

Il sottosistema grafico DirectX può usare un solo buffer DMA per visualizzare (usando la funzione DxgkDdiPresent del driver di visualizzazione) almeno una struttura RECT per tutti gli scenari.
Le dimensioni dei buffer DMA e di elenco di allocazione sono sufficienti per contenere almeno un comando che non può essere suddiviso tra più buffer.
Le dimensioni dei buffer DMA e di elenco di allocazione sono sufficienti per evitare il sovraccarico di configurazione e DMA.

Il driver miniport visualizzato può specificare solo segmenti di apertura nel membro DmaBufferSegmentSet ; se il driver specifica un segmento di memoria, si verifica un errore di creazione del dispositivo.

Se il driver imposta DmaBufferSegmentSet su 0, la gestione memoria video alloca memoria bloccata a pagina contigua, che viene mappata alla memoria combinata di scrittura, per i buffer DMA. Pertanto, la GPU deve accedere ai buffer DMA usando cicli PCI nei sistemi in cui i trasferimenti AGP che si verificano all'esterno dell'apertura AGP non sono consentiti.