struttura DXGK_DEVICEINFO (d3dkmddi.h)
La struttura DXGK_DEVICEINFO descrive i parametri richiesti dal sottosistema kernel della grafica Microsoft DirectX dal driver miniport di visualizzazione.
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;
Membri
[out] DmaBufferSize
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 DmaBufferSize.
[out] DmaBufferSegmentSet
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 di dati privati viene allocata da un pool non di pagine. Se il driver specifica zero in DmaBufferPrivateDataSize, non viene allocata alcuna memoria per la struttura di dati privati.
La struttura di dati privati associata a un buffer DMA viene inizializzata su zero quando viene creato il buffer DMA. Durante la durata del buffer DMA, il gestore di memoria video non accede mai alla struttura dei dati privati 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 nel pAllocationList membri di strutture di DXGKARG_PRESENT e DXGKARG_RENDER nelle chiamate alle funzioni DxgkDdiPresent del driver e dxgkDdiRender.
L'elenco di allocazioni può aumentare e ridursi dopo la creazione del dispositivo; Tuttavia, l'elenco di allocazioni non può mai ridurre le dimensioni iniziali specificate AllocationListSize.
[out] PatchLocationListSize
Numero iniziale di elementi in una matrice di posizioni 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 patch che il driver richiede di trovarsi nel pPatchLocationListIn membri delle strutture di DXGKARG_RENDER nelle chiamate alla relativa funzione DxgkDdiRender.
L'elenco di posizioni patch può aumentare e compattarsi dopo la creazione del dispositivo; Tuttavia, l'elenco di percorsi patch non può mai ridurre le dimensioni iniziali specificate PatchLocationListSize.
[out] Flags
Struttura DXGK_DEVICEINFOFLAGS che identifica, in flag di campo di bit, informazioni sul dispositivo.
Osservazioni
Il driver miniport di visualizzazione 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 miniport di visualizzazione) almeno una struttura RECT per tutti gli scenari.
- Le dimensioni dei buffer DMA e allocation-list sono sufficienti per contenere almeno un comando che non può essere suddiviso tra più buffer.
- Le dimensioni dei buffer DMA e allocation-list sono sufficienti per evitare l'installazione e il sovraccarico DMA.
Se il driver imposta DmaBufferSegmentSet su 0, la gestione memoria video alloca la memoria contigua bloccata a paging, mappata alla memoria combinata di scrittura, per i buffer DMA. Di conseguenza, 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| intestazione | d3dkmddi.h (include D3dkmddi.h) |