структура DXGK_SEGMENTFLAGS (d3dkmddi.h)

Статья
02/23/2024

Структура DXGK_SEGMENTFLAGS определяет свойства сегмента, предоставляемые драйвером посредством вызова функции DxgkDdiQueryAdapterInfo .

Синтаксис

typedef struct _DXGK_SEGMENTFLAGS {
  union {
    struct {
      UINT Aperture : 1;
      UINT Agp : 1;
      UINT CpuVisible : 1;
      UINT UseBanking : 1;
      UINT CacheCoherent : 1;
      UINT PitchAlignment : 1;
      UINT PopulatedFromSystemMemory : 1;
      UINT PreservedDuringStandby : 1;
      UINT PreservedDuringHibernate : 1;
      UINT PartiallyPreservedDuringHibernate : 1;
      UINT DirectFlip : 1;
      UINT Use64KBPages : 1;
      UINT ReservedSysMem : 1;
      UINT SupportsCpuHostAperture : 1;
      UINT SupportsCachedCpuHostAperture : 1;
      UINT ApplicationTarget : 1;
      UINT VprSupported : 1;
      UINT VprPreservedDuringStandby : 1;
      UINT EncryptedPagingSupported : 1;
      UINT LocalBudgetGroup : 1;
      UINT NonLocalBudgetGroup : 1;
      UINT PopulatedByReservedDDRByFirmware : 1;
#if ...
      UINT Reserved : 10;
#elif
      UINT Reserved : 11;
#elif
      UINT Reserved : 21;
#else
      UINT Reserved : 22;
#endif
    };
    UINT Value;
  };
} DXGK_SEGMENTFLAGS;

Члены

Aperture

[out] Значение UINT, указывающее, является ли сегмент сегментом диафрагмы, а не сегментом памяти. Сегмент диафрагмы не содержит физических страниц, на которых можно хранить содержимое для выделения. Когда диспетчер видеопамять передает выделение в сегмент памяти, диспетчер памяти передает содержимое выделения из хранилища системной памяти в расположение сегмента. Когда диспетчер видеопамяли перенаправит выделение в сегмент диафрагмы, диспетчер памяти сопоставляет физические страницы резервного хранилища выделения в сегмент.

Если драйвер указывает этот элемент, он также должен реализовать типы операций map-aperture-segment и unmap-aperture-segment для функции DxgkDdiBuildPagingBuffer .

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

Agp

[out] Значение UINT, указывающее, является ли сегмент сегментом диафрагмы типа AGP**, который использует часть диафрагмы AGP, которую предоставляет набор микросхем. Диспетчер видеопамяли выделяет страницу для базовой диафрагмы и взаимодействует с драйвером таблицы переназначений графического адреса (GART), чтобы сопоставить и отменить сопоставление памяти для диафрагмы. Так как может существовать только один сегмент AGP, драйвер не должен указывать флаг битового поля AGP с другими флагами битовых полей DXGK_SEGMENTFLAGS.

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

CpuVisible

[out] Значение UINT, указывающее, доступен ли сегмент памяти ЦП по адресу, указанному элементом CpuTranslatedAddressструктуры DXGK_SEGMENTDESCRIPTOR , описывающей сегмент памяти.

Этот элемент не имеет значения для сегмента диафрагмы, включая сегмент диафрагмы типа AGP. Единственное исключение возникает, если драйвер отображения пользовательского режима не настроил альтернативный виртуальный адрес для основного выделения (то есть если драйвер не задал UseAlternateVA в элементе Flags структуры D3DDDICB_LOCKFLAGS во время вызова функции pfnLockCb ).

Дополнительные сведения см. в разделе Примечания.

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

UseBanking

[out] Значение UINT, указывающее, делится ли сегмент на банки, которые драйвер использует для предоставления диспетчеру видеопамяти указаний о размещении выделений в сегменте. Драйвер также должен указывать допустимые банковские данные в элементах NbOfBanks и pBankRangeTableструктуры DXGK_SEGMENTDESCRIPTOR , описывающей сегмент.

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

CacheCoherent

[out] Значение UINT, указывающее, может ли сегмент диафрагмы поддерживать когерентность кэша с кэшируемыми страницами, сопоставленными с диафрагмой. Этот элемент можно задать только с помощью элемента Aperture (то есть CacheCoherent не имеет значения для сегмента памяти).

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

PitchAlignment

[out] Значение UINT, указывающее, должно ли выделение, сопоставленное с сегментом, выравниваться по шагу. Для этого типа сегментов диспетчер видеопамять использует элемент Sizeструктуры DXGK_ALLOCATIONINFO для выделения резервного хранилища для выделения. Однако диспетчер видеопамяли использует член PitchAlignedSize DXGK_ALLOCATIONINFO для выделения ресурсов для сегмента. Выделение, предназначенное для этого типа сегмента, обычно имеет другой размер для резервного хранилища и для сегмента. Если размер резервного хранилища не соответствует размеру сегмента, драйвер должен определить, как правильно перемещать данные в выделении. Этот тип сегмента нельзя использовать для вытеснения.

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

PopulatedFromSystemMemory

[out] Значение UINT, указывающее, заполняется ли сегмент памяти из системной памяти, выделенной драйвером во время инициализации. Если сегмент памяти заполняется из системной памяти, зарезервированной BIOS и недоступной операционной системе (то есть операционная система не учитывает эту системную память, когда операционная система сообщает об общем объеме системной памяти), драйвер не должен устанавливать этот флаг. Этот флаг является недопустимым и игнорируется в сегментах диафрагмы.

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

PreservedDuringStandby

[out] Значение UINT, указывающее, сохраняется ли сегмент при переходе в режим ожидания системы питания.

Дополнительные сведения о вариантах перехода на питание см. в разделе Примечания.

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

Поддерживается начиная с Windows 8.

PreservedDuringHibernate

[out] Значение UINT, указывающее, сохраняется ли сегмент при переходе в состояние гибернации системы. Не устанавливайте этот флаг, если только не задан элемент PreservedDuringStandby . Дополнительные сведения о вариантах перехода на питание см. в разделе Примечания.

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

Поддерживается начиная с Windows 8.

PartiallyPreservedDuringHibernate

[out] Значение UINT, указывающее, сохраняется ли сегмент частично при переходе в состояние гибернации системы. Не устанавливайте этот флаг, если только не задан элемент PreservedDuringStandby . Дополнительные сведения о вариантах перехода на питание см. в разделе Примечания.

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

Поддерживается начиная с Windows 8.

DirectFlip

[out] Значение UINT, указывающее, поддерживает ли сегмент выделение прямого перелистывания. В этом случае драйвер должен убедиться, что выделения direct Flip можно закрепить и отсканировать из этого сегмента.

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

Поддерживается начиная с Windows 8.

Use64KBPages

[out] Если этот параметр задан, сегмент памяти GPU поддерживает 64 КБ страниц. В противном случае поддерживаются страницы размером 4 КБ. Когда драйвер устанавливает ограничение и выделение можно выстраивать в сегмент, выравнивание выделения, возвращаемое драйвером режима ядра из DXGK_ALLOCATIONINFO, должно быть кратно 64 КБ.