DXGK_SEGMENTBANKPREFERENCE 结构 (d3dkmddi.h)

项目
05/26/2023

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 成员 (0x0000007F) 的前 7 位。

[out] Direction0

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

此成员等效于 32 位 Value 成员 (0x00000080) 的第 8 位。

[out] Bank1

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

此成员等效于 32 位 Value 成员 (0x00007F00) 的 9 到 15 位。

[out] Direction1

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

此成员等效于 32 位 Value 成员 (0x00008000) 的第 16 位。

[out] Bank2

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

此成员等效于 32 位 Value 成员 (0x007F0000) 的第 17 位到 23 位。

[out] Direction2

应扫描 Bank2 以查找可用内存孔的方向。值为 0 表示自下而上搜索 (即低地址到高地址) ，值 1 表示自上而下搜索 (即高地址到低地址) 。

此成员等效于 32 位 Value 成员 (0x00800000) 的第 24 位。

[out] Bank3

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

此成员等效于 32 位 Value 成员 (0x7F000000) 的第 25 位到 31 位。

[out] Direction3

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

此成员等效于 32 位 Value 成员 (0x80000000) 的 32 秒位。

[out] Value

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

注解

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

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