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

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

[out] Direction0

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

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

[out] Bank1

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

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

[out] Direction1

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

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

[out] Bank2

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

[out] Direction2

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

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

[out] Bank3

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

[out] Direction3

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

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

[out] Value

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

Замечания

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

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