DXGK_SEGMENTBANKPREFERENCE 結構 (d3dkmddi.h)

發行項
02/23/2024

DXGK_SEGMENTBANKPREFERENCE結構描述配置中分頁的銀行喜好設定。

語法

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;

成員

[out] Bank0

慣用最高優先順序銀行的標識碼，如果不需要喜好設定，則為 0。有效值為 1 到 127。

這個成員相當於32位 Value 成員的前7位 (0x0000007F) 。

[out] Direction0

應該掃描 Bank0 以找出可用記憶體區域的方向。值為 0 表示由下而下搜尋 (，也就是低位址到高位址) ，而值為 1 則表示最上層搜尋 (，也就是高位址到低位址) 。

這個成員相當於32位 Value 成員的第八位 (0x00000080) 。

[out] Bank1

下一個最高優先順序慣用銀行的標識符，如果沒有喜好設定，則為 0。有效值為 1 到 127。

這個成員相當於32位 Value 成員的位9到15 (0x00007F00) 。

[out] Direction1

應該掃描 Bank1 的方向，以找出記憶體的可用孔。值為 0 表示由下而下搜尋 (，也就是低位址到高位址) ，而值為 1 則表示最上層搜尋 (，也就是高位址到低位址) 。

這個成員相當於32位 Value 成員的第十六位 (0x00008000) 。

[out] Bank2

下一個最高優先順序慣用銀行的標識符，如果沒有喜好設定，則為 0。有效值為 1 到 127。

這個成員相當於32位 Value 成員的位17到23 (0x007F0000) 。

[out] Direction2

應該掃描 Bank2 的方向，以找出記憶體的可用孔。值為 0 表示由下而下搜尋 (，也就是低位址到高位址) ，而值為 1 則表示最上層搜尋 (，也就是高位址到低位址) 。

這個成員相當於32位 Value 成員 (0x00800000) 的第二十四位。

[out] Bank3

下一個最高優先順序慣用銀行的標識符，如果沒有喜好設定，則為 0。有效值為 1 到 127。

這個成員相當於32位 Value 成員的位25到31 (0x7F000000) 。

[out] Direction3

應該掃描 Bank3 的方向，以找出記憶體的可用孔。值為 0 表示由下而下搜尋 (，也就是低位址到高位址) ，而值為 1 則表示最上層搜尋 (，也就是高位址到低位址) 。

這個成員相當於32位 Value 成員 (0x80000000) 的32秒位。

[out] Value

DXGK_SEGMENTBANKPREFERENCE的等位成員包含可保存識別銀行喜好設定的32位值。

備註

呼叫驅動程式的 DxgkDdiCreateAllocation 函式時，顯示迷你埠驅動程式最多可以在DXGK_ALLOCATIONINFO結構的 HintedBank 成員中指出四個銀行喜好設定。慣用銀行標識碼是以單一為基礎的 (，也就是第一個銀行有一個) 的標識符。零的標識子表示驅動程序沒有喜好設定。 在 Bank0 成員中指定最高優先順序喜好設定;在 Bank3 成員中指定最低優先順序喜好設定。驅動程式可以將銀行標識碼的優先順序較低的喜好設定設為零，以指定少於四個喜好設定。例如，驅動程式可以將 Bank0 和 Bank1 設定為有效的標識碼，並將 Bank2 和 Bank3 設定為零，以指定兩個喜好設定。驅動程式可以使用每個 DirectionX 成員，個別指定每個銀行喜好設定的掃描方向。

視訊記憶體管理員會從 preferredSegment 成員所指定的慣用區段配置資源DXGK_ALLOCATIONINFO。