DXGK_SEGMENTBANKPREFERENCE结构（d3dkmddi.h）

项目
02/06/2025

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 位值成员的前 7 位（0x0000007F）。

[out] Direction0

应扫描 Bank0 的方向，以找到一个可用内存区域。值为 0 表示自下而上搜索（即低地址到高地址），值 1 表示从上到下搜索（即高地址到低地址）。

此成员相当于 32 位值成员（0x00000080）的第八位。

[out] Bank1

下一个最高优先级首选银行的标识符;如果没有首选项，则为 0。有效值为 1 到 127。

此成员相当于 32 位值成员（0x00007F00）中的位 9 到 15 位。

[out] Direction1

应扫描 Bank1 的方向，以找到一个可用内存孔。值为 0 表示自下而上搜索（即低地址到高地址），值 1 表示从上到下搜索（即高地址到低地址）。

此成员等效于 32 位 Value 成员（0x00008000）的第 16 位。

[out] Bank2

下一个最高优先级首选银行的标识符;如果没有首选项，则为 0。有效值为 1 到 127。

此成员相当于 32 位值成员（0x007F0000）中的位 17 到 23 位。

[out] Direction2

应扫描 Bank2 的方向，以找到一个可用内存洞。值为 0 表示自下而上搜索（即低地址到高地址），值 1 表示从上到下搜索（即高地址到低地址）。

此成员等效于 32 位 Value 成员（0x00800000）的第 24 位。

[out] Bank3

下一个最高优先级首选银行的标识符;如果没有首选项，则为 0。有效值为 1 到 127。

此成员相当于 32 位值成员（0x7F000000）中的位 25 到 31 位。

[out] Direction3

应扫描 Bank3 的方向，以找到一个可用内存孔。值为 0 表示自下而上搜索（即低地址到高地址），值 1 表示从上到下搜索（即高地址到低地址）。

此成员相当于 32 位 Value 成员（0x80000000）的 32 位位。

[out] Value

联合中的成员，该成员DXGK_SEGMENTBANKPREFERENCE包含可以保存标识银行首选项的 32 位值。

言论

调用驱动程序的 DxgkDdiCreateAllocation 函数时，显示微型端口驱动程序最多可以指示 DXGK_ALLOCATIONINFO 结构 HintedBank 成员中的四个银行首选项。首选银行标识符是基于一个（即，第一个银行有一个标识符）。零的标识符指示驱动程序没有首选项。 Bank0 成员中指定了最高优先级首选项;Bank3 成员中指定了最低优先级首选项。驱动程序可以通过将银行标识符的优先级较低的首选项设置为零来指定小于 4 个首选项。例如，驱动程序可以通过将 Bank0 和 Bank1 设置为有效标识符并 Bank2 和 Bank3 设置为零来指定两个首选项。驱动程序可以使用每个方向X 成员单独为每个银行首选项指定扫描方向。

视频内存管理器从 PreferredSegment DXGK_ALLOCATIONINFO 成员指定的首选段分配资源。