DXGK_SEGMENTBANKPREFERENCE Struktur (d3dkmddi.h)

Artikel
02/23/2024

Die DXGK_SEGMENTBANKPREFERENCE-Struktur beschreibt Bankpräferenzen für das Paging in einer Zuordnung.

Syntax

typedef struct _DXGK_SEGMENTBANKPREFERENCE {
  union {
    struct {
      UINT Bank0 : 7;
      UINT Direction0 : 1;
      UINT Bank1 : 7;
      UINT Direction1 : 1;
      UINT Bank2 : 7;
      UINT Direction2 : 1;
      UINT Bank3 : 7;
      UINT Direction3 : 1;
    };
    [out] UINT Value;
  };
} DXGK_SEGMENTBANKPREFERENCE;

Member

[out] Bank0

Der Bezeichner der bevorzugten Bank mit der höchsten Priorität oder 0, wenn keine Präferenz erforderlich ist. Gültige Werte liegen zwischen 1 und 127.

Dieses Element entspricht den ersten 7 Bits des 32-Bit-Wertmembers (0x0000007F).

[out] Direction0

Die Richtung, in der Bank0 gescannt werden soll, um einen freien Speicherbereich zu finden. Der Wert 0 gibt eine Bottom-up-Suche an (d. a. niedrige Adresse zu hohe Adresse), und der Wert 1 gibt eine Suche von oben nach unten an (also hohe Adresse bis niedrige Adresse).

Dieses Element entspricht dem achten Bit des 32-Bit-Wert-Members (0x00000080).

[out] Bank1

Der Bezeichner der bevorzugten Bank mit der nächsthöchsten Priorität oder 0, wenn keine Präferenz erforderlich ist. Gültige Werte liegen zwischen 1 und 127.

Dieser Member entspricht den Bits 9 bis 15 des 32-Bit-Wert-Members (0x00007F00).

[out] Direction1

Die Richtung, in der Bank1 gescannt werden soll, um eine freie Speicherlücke zu finden. Der Wert 0 gibt eine Bottom-up-Suche an (d. a. niedrige Adresse zu hohe Adresse), und der Wert 1 gibt eine Suche von oben nach unten an (also hohe Adresse bis niedrige Adresse).

Dieses Element entspricht dem sechzehnten Bit des 32-Bit-Wertmembers (0x00008000).

[out] Bank2

Der Bezeichner der bevorzugten Bank mit der nächsthöchsten Priorität oder 0, wenn keine Präferenz erforderlich ist. Gültige Werte liegen zwischen 1 und 127.

Dieses Element entspricht bits 17 bis 23 des 32-Bit-Wert-Members (0x007F0000).

[out] Direction2

Die Richtung, in der Bank2 gescannt werden soll, um ein freies Loch des Arbeitsspeichers zu finden. Der Wert 0 gibt eine Bottom-up-Suche an (d. a. niedrige Adresse zu hohe Adresse), und der Wert 1 gibt eine Suche von oben nach unten an (also hohe Adresse bis niedrige Adresse).

Dieses Element entspricht dem vierundzwanzigten Bit des 32-Bit-Wertmembers (0x00800000).

[out] Bank3

Der Bezeichner der bevorzugten Bank mit der nächsthöchsten Priorität oder 0, wenn keine Präferenz erforderlich ist. Gültige Werte liegen zwischen 1 und 127.

Dieses Element entspricht Bits 25 bis 31 des 32-Bit-Wertelements (0x7F000000).

[out] Direction3

Die Richtung, in der Bank3 gescannt werden soll, um ein freies Loch des Arbeitsspeichers zu finden. Der Wert 0 gibt eine Bottom-up-Suche an (d. a. niedrige Adresse zu hohe Adresse), und der Wert 1 gibt eine Suche von oben nach unten an (also hohe Adresse bis niedrige Adresse).

Dieses Element entspricht dem Dreißigsekundenbit des 32-Bit-Wertmembers (0x80000000).

[out] Value

Ein Mitglied in der Union, das DXGK_SEGMENTBANKPREFERENCE enthält, das einen 32-Bit-Wert enthalten kann, der Bankpräferenzen identifiziert.

Hinweise

Der Anzeigeminiporttreiber kann bis zu vier Bankeinstellungen im HintedBank-Member einer DXGK_ALLOCATIONINFO-Struktur angeben, wenn die DxgkDdiCreateAllocation-Funktion des Treibers aufgerufen wird. Bevorzugte Bankbezeichner sind einsbasiert (d. a. die erste Bank verfügt über einen Identifikator von 1). Ein Bezeichner von null gibt an, dass der Treiber keine Einstellung hat. Die Präferenz mit der höchsten Priorität wird im Bank0-Mitglied angegeben. die niedrigste Prioritätseinstellung wird im Bank3-Element angegeben. Der Treiber kann weniger als vier Einstellungen angeben, indem er die niedrigeren Prioritätseinstellungen von Bankbezeichnern auf Null festlegt. Der Treiber kann beispielsweise zwei Einstellungen angeben, indem er Bank0 und Bank1 auf gültige Bezeichner und Bank2 und Bank3 auf Null festlegt. Der Treiber kann jedes DirectionX-Element verwenden, um die Scanrichtung für jede Bankpräferenz unabhängig anzugeben.

Der Videospeicher-Manager weist Ressourcen aus bevorzugten Segmenten zu, die das PreferredSegment-Mitglied von DXGK_ALLOCATIONINFO angibt.