struttura DXGK_SEGMENTDESCRIPTOR4 (d3dkmddi.h)
La struttura DXGK_SEGMENTDESCRIPTOR4 descrive un'apertura dell'host CPU programmabile.
Sintassi
typedef struct _DXGK_SEGMENTDESCRIPTOR4 {
DXGK_SEGMENTFLAGS Flags;
PHYSICAL_ADDRESS BaseAddress;
SIZE_T Size;
SIZE_T CommitLimit;
SIZE_T SystemMemoryEndAddress;
union {
PHYSICAL_ADDRESS CpuTranslatedAddress;
DXGK_CPUHOSTAPERTURE CpuHostAperture;
};
UINT NumInvalidMemoryRanges;
SIZE_T VprRangeStartOffset;
SIZE_T VprRangeSize;
UINT VprAlignment;
UINT NumVprSupported;
UINT VprReserveSize;
UINT NumUEFIFrameBufferRanges;
} DXGK_SEGMENTDESCRIPTOR4;
Membri
Flags
Flag di campo di bit segmento
BaseAddress
Indirizzo di base fisico per il segmento nella GPU.
Size
Dimensione del segmento in byte.
CommitLimit
Numero massimo di byte di cui è possibile eseguire il commit in questo segmento. Questo valore si applica solo al segmento di apertura.
SystemMemoryEndAddress
Per i segmenti parzialmente composti dalla memoria di sistema, tutte le allocazioni che terminano dopo l'eliminazione di questo indirizzo durante l'ibernazione.
CpuTranslatedAddress
Se Flags.SupportsCpuHostAperture==FALSE e il segmento è visibile alla CPU, questo sarà l'indirizzo di base fisico della CPU del segmento.
CpuHostAperture
Se Flags.SupportsCpuHostAperture==TRUE, l'indirizzo della CPU e le dimensioni dell'CPUHostAperture.
NumInvalidMemoryRanges
Numero di intervalli di memoria non validi nel segmento. Se questo valore non è zero, il driver in modalità kernel verrà chiamato con DdiQueryAdapterInfo(DXGKQAITYPE_SEGMENTMEMORYSTATE) per ottenere informazioni sugli intervalli di memoria non validi.
VprRangeStartOffset
Offset iniziale dell'intervallo di aree protette video, in byte.
VprRangeSize
Dimensioni dell'intervallo di aree protette video, in byte.
VprAlignment
Allineamento dell'intervallo di aree protette video, in byte. Questo valore si applica sia alla dimensione che all'offset iniziale dell'intervallo di aree protette video.
NumVprSupported
Numero di intervalli video protetti supportati nell'intervallo VPR. Un valore pari a zero indica il supporto per un numero infinito.
VprReserveSize
Dimensioni dell'area nell'intervallo VPR riservato al driver/hardware da usare, in byte. Un valore pari a zero indica nessuna riserva.
NumUEFIFrameBufferRanges
Numero di intervalli di buffer dei frame UEFI nel segmento. Supportato a partire da WDDM 2.2.
Osservazioni
Questa struttura viene usata da un driver miniport in modalità kernel WDDM 2.0 o versione successiva per restituire informazioni sui segmenti di memoria in risposta a una chiamata di funzione DxgkDdiQueryAdapterInfo in cui il sottosistema grafico specifica il valore DXGKQAITYPE_QUERYSEGMENT4 nella Type membro della struttura DXGKARG_QUERYADAPTERINFO.
Questa struttura punta a pSegmentDescriptor membro della struttura DXGK_QUERYSEGMENTOUT4.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10 (WDDM 2.0) |
| server minimo supportato | Windows Server 2016 |
| intestazione | d3dkmddi.h (include D3dkmddi.h) |