структура 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.

Этот элемент эквивалентен первым 7 битам 32-разрядного элемента Value (0x0000007F).

[out] Direction0

Направление, в котором следует сканировать Bank0 , чтобы найти свободную область памяти. Значение 0 означает поиск снизу вверх (т. е. с низкого адреса на высокий адрес), а значение 1 указывает на поиск сверху вниз (т. е. с высокого адреса на низкий адрес).

Этот элемент эквивалентен восьмому биту 32-разрядного элемента Value (0x00000080).

[out] Bank1

Идентификатор следующего предпочтительного банка с наивысшим приоритетом или 0, если предпочтение не требуется. Допустимые значения: от 1 до 127.

Этот элемент эквивалентен 9–15 битам 32-разрядного элемента Value (0x00007F00).

[out] Direction1

Направление, в котором следует сканировать Bank1 , чтобы найти свободное отверстие в памяти. Значение 0 означает поиск снизу вверх (т. е. с низкого адреса на высокий адрес), а значение 1 указывает на поиск сверху вниз (т. е. с высокого адреса на низкий адрес).

Этот элемент эквивалентен шестнадцатой биту 32-разрядного элемента Value (0x00008000).

[out] Bank2

Этот элемент эквивалентен 17–23 битам 32-разрядного элемента Value (0x007F0000).

[out] Direction2

Направление, в котором следует сканировать Bank2 , чтобы найти свободное отверстие в памяти. Значение 0 означает поиск снизу вверх (т. е. с низкого адреса на высокий адрес), а значение 1 указывает на поиск сверху вниз (т. е. с высокого адреса на низкий адрес).

Этот элемент эквивалентен двадцать четвертому биту 32-разрядного элемента Value (0x00800000).

[out] Bank3

Этот элемент эквивалентен битам от 25 до 31 32-разрядного элемента Value (0x7F000000).

[out] Direction3

Направление, в котором следует сканировать Bank3 , чтобы найти свободное отверстие в памяти. Значение 0 означает поиск снизу вверх (т. е. с низкого адреса на высокий адрес), а значение 1 указывает на поиск сверху вниз (т. е. с высокого адреса на низкий адрес).

Этот элемент эквивалентен тридцатисекундной части 32-разрядного элемента Value (0x80000000).

[out] Value

Член объединения, который DXGK_SEGMENTBANKPREFERENCE содержит, который может содержать 32-разрядное значение, определяющее банковские предпочтения.

Драйвер мини-порта дисплея может указывать до четырех банковских предпочтений в элементе HintedBankструктуры DXGK_ALLOCATIONINFO при вызове функции DxgkDdiCreateAllocation драйвера. Идентификаторы предпочтительного банка основаны на одном (то есть первый банк имеет идентификатор одного). Идентификатор с нулевым значением указывает, что драйвер не имеет предпочтений. Предпочтение с наивысшим приоритетом указывается в члене Bank0 ; Приоритет с наименьшим приоритетом указывается в члене Bank3 . Драйвер может указать менее четырех параметров, установив для нулевых параметров нижнего приоритета идентификаторов банков. Например, драйвер может указать два параметра, задав в Bank0 и Bank1 допустимые идентификаторы, а для Bank2 и Bank3 — нулевое значение. Драйвер может использовать каждый элемент DirectionX для указания направления сканирования для каждого банковского предпочтения независимо друг от друга.

Диспетчер видеопаметь выделяет ресурсы из предпочтительных сегментов, которые указывает элемент PreferredSegment DXGK_ALLOCATIONINFO.