DXGK_SEGMENTFLAGS Struktur (d3dkmddi.h)

Artikel
02/06/2025

Die DXGK_SEGMENTFLAGS Struktur identifiziert Eigenschaften für ein Segment, das der Treiber über einen Aufruf seiner DxgkDdiQueryAdapterInfo Funktion bereitstellt.

Syntax

typedef struct _DXGK_SEGMENTFLAGS {
  union {
    struct {
      UINT Aperture : 1;
      UINT Agp : 1;
      UINT CpuVisible : 1;
      UINT UseBanking : 1;
      UINT CacheCoherent : 1;
      UINT PitchAlignment : 1;
      UINT PopulatedFromSystemMemory : 1;
      UINT PreservedDuringStandby : 1;
      UINT PreservedDuringHibernate : 1;
      UINT PartiallyPreservedDuringHibernate : 1;
      UINT DirectFlip : 1;
      UINT Use64KBPages : 1;
      UINT ReservedSysMem : 1;
      UINT SupportsCpuHostAperture : 1;
      UINT SupportsCachedCpuHostAperture : 1;
      UINT ApplicationTarget : 1;
      UINT VprSupported : 1;
      UINT VprPreservedDuringStandby : 1;
      UINT EncryptedPagingSupported : 1;
      UINT LocalBudgetGroup : 1;
      UINT NonLocalBudgetGroup : 1;
      UINT PopulatedByReservedDDRByFirmware : 1;
#if ...
      UINT Reserved : 10;
#elif
      UINT Reserved : 11;
#elif
      UINT Reserved : 21;
#else
      UINT Reserved : 22;
#endif
    };
    UINT Value;
  };
} DXGK_SEGMENTFLAGS;

Angehörige

Aperture

[out] Ein UINT-Wert, der angibt, ob es sich bei dem Segment um ein Blendensegment anstelle eines Speichersegments handelt. Ein Blendensegment verfügt nicht über physische Seiten, die Inhalte für eine Zuordnung enthalten können. Wenn der Videospeicher-Manager eine Zuordnung in ein Speichersegment aufgibt, überträgt der Speicher-Manager den Inhalt der Zuordnung vom Speicher des Systems an den Segmentspeicherort. Wenn der Videospeicher-Manager eine Zuordnung in ein Blendensegment aufgibt, ordnet der Speichermanager die physischen Seiten der Zuordnungsspeicher in das Segment zu.

Wenn der Treiber dieses Element angibt, muss er auch die Karten-Blendensegment- und Unmap-Blendensegment-Vorgangstypen für seine DxgkDdiBuildPagingBuffer--Funktion implementieren.

Das Festlegen dieses Elements entspricht dem Festlegen des ersten Bits des 32-Bit-Value Members (0x00000001).

Agp

[out] Ein UINT-Wert, der angibt, ob das Segment ein AGP**-Typ Blendensegment ist, das einen Teil der AGP-Blende verwendet, die der Chipsatz verfügbar macht. Der Videospeicher-Manager weist die Seite für die zugrunde liegende Blende zu und kommuniziert mit dem Grafikadressen-Neuzuordnungstabellentreiber (GART) zum Zuordnen und Aufheben der Zuordnung des Speichers für die Blende. Da nur ein AGP-Segment vorhanden sein kann, sollte der Treiber nicht das Agp- Bitfeld-Flag mit anderen DXGK_SEGMENTFLAGS Bitfeld-Flags angeben.

Das Festlegen dieses Elements entspricht dem Festlegen des zweiten Bits des 32-Bit-Value Members (0x00000002).

CpuVisible

[out] Ein UINT-Wert, der angibt, ob auf die CPU an der Adresse zugegriffen werden kann, die durch die CpuTranslatedAddress Mitglied der DXGK_SEGMENTDESCRIPTOR Struktur angegeben wird, die das Speichersegment beschreibt.

Dieses Element hat keine Bedeutung für ein Blendensegment, einschließlich des AGP-Typ-Blendensegments. Die einzige Ausnahme tritt auf, wenn der Anzeigetreiber für den Benutzermodus keine alternative virtuelle Adresse für eine primäre Zuordnung eingerichtet hat (d. a., wenn der Treiber UseAlternateVA im Flags Member der D3DDDICB_LOCKFLAGS Struktur während eines Aufrufs der pfnLockCb-Funktion nicht festgelegt hat).

Weitere Informationen finden Sie in den Hinweisen.

Das Festlegen dieses Elements entspricht dem Festlegen des dritten Bits des 32-Bit-Value Members (0x00000004).

UseBanking

[out] Ein UINT-Wert, der angibt, ob das Segment in Banken unterteilt ist, die der Treiber verwendet, um dem Videospeichermanager Hinweise zur Platzierung von Zuordnungen innerhalb des Segments bereitzustellen. Der Treiber sollte auch gültige Bankinformationen in den NbOfBanks und pBankRangeTable Mitglieder der DXGK_SEGMENTDESCRIPTOR Struktur angeben, die das Segment beschreibt.

Das Festlegen dieses Elements entspricht dem Festlegen des vierten Bits des 32-Bit-Value Members (0x00000008).

CacheCoherent

[out] Ein UINT-Wert, der angibt, ob das Blendensegment die Cachekohärenz mit zwischenspeicherbaren Seiten beibehalten kann, die in der Blende zugeordnet sind. Dieses Element kann nur mit dem Festlegen des Blend Members festgelegt werden (d. h. CacheCoherent hat keine Bedeutung für ein Speichersegment).

Das Festlegen dieses Elements entspricht dem Festlegen des fünften Bits des 32-Bit-Value Members (0x00000010).

PitchAlignment

[out] Ein UINT-Wert, der angibt, ob eine Zuordnung, die dem Segment zugeordnet ist, ausgerichtet sein muss. Für diese Art von Segment verwendet der Videospeicher-Manager das Size Member der DXGK_ALLOCATIONINFO-Struktur für die Zuordnung, um einen Sicherungsspeicher für die Zuordnung zuzuweisen. Der Videospeicher-Manager verwendet jedoch die PitchAlignedSize Member von DXGK_ALLOCATIONINFO, um Ressourcen für das Segment zuzuweisen. Eine Zuordnung, die für diese Art von Segment vorgesehen ist, weist in der Regel eine andere Größe für den Sicherungsspeicher und für das Segment auf. Wenn die Größe des Sicherungsspeichers nicht mit der Segmentgröße übereinstimmt, muss der Treiber bestimmen, wie die Daten in der Zuordnung ordnungsgemäß verschoben werden. Diese Art von Segment kann nicht für die Entfernung verwendet werden.

Das Festlegen dieses Elements entspricht dem Festlegen des sechsten Bits des 32-Bit-Value Members (0x00000020).

PopulatedFromSystemMemory

[out] Ein UINT-Wert, der angibt, ob das Speichersegment tatsächlich aus dem Systemspeicher aufgefüllt wird, den der Treiber während der Initialisierung zugewiesen hat. Wenn das Speichersegment aus dem Systemspeicher aufgefüllt wird, den das BIOS reserviert hat und nicht auf das Betriebssystem zugreifen kann (d. h. das Betriebssystem zählt diesen Systemspeicher nicht, wenn das Betriebssystem die Gesamtmenge des Systemspeichers meldet), sollte der Treiber dieses Kennzeichen nicht festlegen. Diese Kennzeichnung ist ungültig und wird auf Blendensegmenten ignoriert.

Das Festlegen dieses Elements entspricht dem Festlegen des siebten Bits des 32-Bit-Value Members (0x00000040).

PreservedDuringStandby

[out] Ein UINT-Wert, der angibt, ob das Segment in einem Übergang zu einem Standbysystem-Energiezustand beibehalten wird.

Weitere Informationen zu Optionen für den Energieübergang finden Sie in den Anmerkungen.

Das Festlegen dieses Elements entspricht dem Festlegen des achten Bits des 32-Bit-Value Members (0x00000080).

Wird ab Windows 8 unterstützt.

PreservedDuringHibernate

[out] Ein UINT-Wert, der angibt, ob das Segment in einem Übergang zu einem Ruhezustand des Systems beibehalten wird. Legen Sie dieses Flag nicht fest, es sei denn, der PreservedDuringStandby Member ist ebenfalls festgelegt. Weitere Informationen zu Optionen für den Energieübergang finden Sie in den Anmerkungen.

Das Festlegen dieses Elements entspricht dem Festlegen des neunten Bits des 32-Bit-Value Members (0x00000100).

Wird ab Windows 8 unterstützt.

PartiallyPreservedDuringHibernate

[out] Ein UINT-Wert, der angibt, ob das Segment teilweise in einem Übergang zu einem Ruhezustand des Systems beibehalten wird. Legen Sie dieses Flag nicht fest, es sei denn, der PreservedDuringStandby Member ist ebenfalls festgelegt. Weitere Informationen zu Optionen für den Energieübergang finden Sie in den Anmerkungen.

Das Festlegen dieses Elements entspricht dem Festlegen des zehnten Bits des 32-Bit-Value Members (0x00000200).

Wird ab Windows 8 unterstützt.

DirectFlip

[out] Ein UINT-Wert, der angibt, ob ein Segment Direct Flip-Zuordnungen unterstützt. In diesem Fall muss der Treiber sicherstellen, dass direkte Flip-Zuordnungen angeheftet und aus diesem Segment gescannt werden können.

Das Festlegen dieses Elements entspricht dem Festlegen des elften Bits des 32-Bit-Value Members (0x00000400).

Wird ab Windows 8 unterstützt.

Use64KBPages

[out] Wenn festgelegt, unterstützt das GPU-Speichersegment 64 KB Seiten. Andernfalls werden 4 KB Seiten unterstützt. Wenn der Treiber die Obergrenze festlegt und eine Zuordnung in das Segment eingelagert werden kann, muss die Zuordnungsausrichtung, die vom Kernelmodustreiber von DXGK_ALLOCATIONINFOzurückgegeben wird, mehrere 64 KB sein.