DXGK_SEGMENTDESCRIPTOR4-Struktur (d3dkmddi.h)

  • Artikel

Die DXGK_SEGMENTDESCRIPTOR4-Struktur beschreibt eine programmierbare CPU-Hostpertur.

Syntax

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;

Member

Flags

Segmentbitfeldflags

BaseAddress

Die physische Basisadresse für das Segment in der GPU.

Size

Die Größe des Segments in Bytes.

CommitLimit

Die maximale Anzahl von Bytes, die für dieses Segment committet werden können. Dieser Wert gilt nur für das Blendensegment.

SystemMemoryEndAddress

Bei Segmenten, die teilweise aus Systemspeicher bestehen, werden alle Zuordnungen, die nach dieser Adresse enden, während des Ruhezustands gelöscht.

CpuTranslatedAddress

Wenn Flags.SupportsCpuHostAperture==FALSE und das Segment CPU sichtbar ist, ist dies die physische CPU-Basisadresse des Segments.

CpuHostAperture

Wenn Flags.SupportsCpuHostAperture==TRUE ist, weist diese die CPU-Adresse und die Größe der CPUHostAperture auf.

NumInvalidMemoryRanges

Die Anzahl ungültiger Speicherbereiche im Segment. Wenn dieser Wert nicht null ist, wird der Kernelmodustreiber mit DdiQueryAdapterInfo(DXGKQAITYPE_SEGMENTMEMORYSTATE) aufgerufen, um Informationen zu ungültigen Speicherbereichen abzurufen.

VprRangeStartOffset

Startoffset des videogeschützten Bereichs in Bytes.

VprRangeSize

Größe des videogeschützten Bereichs in Bytes.

VprAlignment

Ausrichtung des videogeschützten Bereichs in Bytes. Dieser Wert gilt sowohl für die Größe als auch für den Startoffset des videogeschützten Bereichs.

NumVprSupported

Anzahl der unterstützten videogeschützten Bereiche im VPR-Bereich. Der Wert 0 (null) gibt an, dass eine unendliche Zahl unterstützt wird.

VprReserveSize

Größe des Bereichs im VPR-Bereich, der für den zu verwendenden Treiber/Hardware reserviert ist, in Byte. Der Wert 0 (null) gibt keine Reserve an.

NumUEFIFrameBufferRanges

Anzahl der UEFI-Framepufferbereiche im Segment. Unterstützt ab WDDM 2.2.

Hinweise

Diese Struktur wird von einem WDDM 2.0 oder höher-Kernelmodus-Miniporttreibern verwendet, um Informationen zu Speichersegmenten als Reaktion auf einen DxgkDdiQueryAdapterInfo-Funktionsaufruf zurückzugeben, in dem das Grafiksubsystem den DXGKQAITYPE_QUERYSEGMENT4 Wert im Type-Member der DXGKARG_QUERYADAPTERINFO-Struktur angibt.

Auf diese Struktur verweist der pSegmentDescriptor-Member der DXGK_QUERYSEGMENTOUT4-Struktur .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 (WDDM 2.0)
Unterstützte Mindestversion (Server) Windows Server 2016
Kopfzeile d3dkmddi.h (einschließlich D3dkmddi.h)

Weitere Informationen

DXGK_QUERYSEGMENTOUT4

DXGKARG_QUERYADAPTERINFO

DxgkDdiQueryAdapterInfo