Перечисление DXGK_QUERYADAPTERINFOTYPE (d3dkmddi.h)

  • Статья

Перечисление DXGK_QUERYADAPTERINFOTYPE указывает тип сведений, извлекаемых при вызове функции DxgkDdiQueryAdapterInfo драйвера мини-порта дисплея.

Синтаксис

typedef enum _DXGK_QUERYADAPTERINFOTYPE {
  DXGKQAITYPE_UMDRIVERPRIVATE = 0,
  DXGKQAITYPE_DRIVERCAPS = 1,
  DXGKQAITYPE_QUERYSEGMENT = 2,
  DXGKQAITYPE_RESERVED = 3,
  DXGKQAITYPE_QUERYSEGMENT2 = 4,
  DXGKQAITYPE_QUERYSEGMENT3 = 5,
  DXGKQAITYPE_NUMPOWERCOMPONENTS = 6,
  DXGKQAITYPE_POWERCOMPONENTINFO = 7,
  DXGKQAITYPE_PREFERREDGPUNODE = 8,
  DXGKQAITYPE_POWERCOMPONENTPSTATEINFO = 9,
  DXGKQAITYPE_HISTORYBUFFERPRECISION = 10,
  DXGKQAITYPE_QUERYSEGMENT4 = 11,
  DXGKQAITYPE_SEGMENTMEMORYSTATE = 12,
  DXGKQAITYPE_GPUMMUCAPS = 13,
  DXGKQAITYPE_PAGETABLELEVELDESC = 14,
  DXGKQAITYPE_PHYSICALADAPTERCAPS = 15,
  DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION = 16,
  DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR = 17,
  DXGKQAITYPE_UEFIFRAMEBUFFERRANGES = 18,
  DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES = 19,
  DXGKQAITYPE_DISPLAYID_DESCRIPTOR = 20,
  DXGKQAITYPE_FRAMEBUFFERSAVESIZE = 21,
  DXGKQAITYPE_HARDWARERESERVEDRANGES = 22,
  DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2 = 23,
  DXGKQAITYPE_NODEPERFDATA = 24,
  DXGKQAITYPE_ADAPTERPERFDATA = 25,
  DXGKQAITYPE_ADAPTERPERFDATA_CAPS = 26,
  DXGKQAITYPE_GPUVERSION = 27,
  DXGKQAITYPE_DEVICE_TYPE_CAPS = 28,
  DXGKQAITYPE_WDDMDEVICECAPS = 29,
  DXGKQAITYPE_GPUPCAPS = 30,
  DXGKQAITYPE_QUERYTARGETGAMMACAPS = 31,
  DXGKQAITYPE_SCANOUT_CAPS = 33,
  DXGKQAITYPE_PHYSICAL_MEMORY_CAPS = 34,
  DXGKQAITYPE_IOMMU_CAPS = 35,
  DXGKQAITYPE_HARDWARERESERVEDRANGES2,
  DXGKQAITYPE_NATIVE_FENCE_CAPS,
  DXGKQAITYPE_USERMODESUBMISSION_CAPS
} DXGK_QUERYADAPTERINFOTYPE;

Константы

 
DXGKQAITYPE_UMDRIVERPRIVATE
Значение: 0
Указывает частную структуру данных, определяемую собственной собственностью, для драйвера отображения.
DXGKQAITYPE_DRIVERCAPS
Значение: 1
Драйвер минипорта дисплея должен заполнять DXGK_DRIVERCAPS структуру своими возможностями драйвера.
DXGKQAITYPE_QUERYSEGMENT
Значение: 2
Драйвер мини-порта дисплея должен заполнять структуру DXGK_QUERYSEGMENTOUT сведениями о сегменте памяти.
DXGKQAITYPE_RESERVED
Значение: 3
Зарезервировано для системного использования. Не используйте в драйвере. Эта константа возникает, начиная с Windows 7.
DXGKQAITYPE_QUERYSEGMENT2
Значение: 4
Зарезервировано для системного использования. Не используйте в драйвере. Эта константа возникает, начиная с Windows 7.
DXGKQAITYPE_QUERYSEGMENT3
Значение: 5
Драйвер мини-порта дисплея должен заполнять структуру DXGK_QUERYSEGMENTOUT3 сведениями о сегменте памяти. Поддерживается начиная с Windows 8.
DXGKQAITYPE_NUMPOWERCOMPONENTS
Значение: 6
Мини-порт дисплея должен предоставлять значение UINT, указывающее количество используемых компонентов питания. Поддерживается начиная с Windows 8.
DXGKQAITYPE_POWERCOMPONENTINFO
Значение: 7
Драйвер мини-порта дисплея должен заполнить структуру DXGK_POWER_RUNTIME_COMPONENT сведениями о n-мкомпоненте питания, где n — индекс компонента, указанный DXGKARG_QUERYADAPTERINFO.pInputData в вызове DxgkDdiQueryAdapterInfo. Поддерживается начиная с Windows 8.
DXGKQAITYPE_PREFERREDGPUNODE
Значение: 8
Зарезервировано для системного использования. Не используйте в драйвере. Эта константа возникает начиная с Windows 8.
DXGKQAITYPE_POWERCOMPONENTPSTATEINFO
Значение: 9
Зарезервировано для системного использования. Не используйте в драйвере. Поддерживается начиная с Windows 8.1.
DXGKQAITYPE_HISTORYBUFFERPRECISION
Значение: 10
Драйвер мини-порта дисплея должен заполнить структуру DXGKARG_HISTORYBUFFERPRECISION сведениями о точности данных буфера журнала, которые он использует. Поддерживается начиная с Windows 8.1.
DXGKQAITYPE_QUERYSEGMENT4
Значение: 11
Драйвер мини-порта дисплея должен заполнить структуру DXGK_QUERYSEGMENTOUT4 , чтобы указать сведения о сегменте памяти. Поддерживается начиная с Windows 10.
DXGKQAITYPE_SEGMENTMEMORYSTATE
Значение: 12
Драйвер минипорта дисплея должен заполнять структуру DXGK_MEMORYRANGE диапазонами неправильной памяти. Поддерживается начиная с Windows 10.
DXGKQAITYPE_GPUMMUCAPS
Значение: 13
Драйвер мини-порта дисплея должен заполнить DXGK_GPUMMUCAPS структуру своими возможностями управления виртуальной памятью. Поддерживается начиная с Windows 10.
DXGKQAITYPE_PAGETABLELEVELDESC
Значение: 14
Зарезервировано для системного использования. Не используйте в драйвере. Эта константа возникает начиная с Windows 10.
DXGKQAITYPE_PHYSICALADAPTERCAPS
Значение: 15
Зарезервировано для системного использования. Не используйте в драйвере. Эта константа возникает начиная с Windows 10.
DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION
Значение: 16
Зарезервировано для системного использования. Не используйте в драйвере. Эта константа возникает начиная с Windows 10.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR
Значение: 17
Поддерживается начиная с Windows 10 версии 1703. Указывает запрос на встроенный дескриптор панели, где входной буфер запроса будет DXGK_QUERYINTEGRATEDDISPLAYIN структурой, а выходной буфер — DXGK_QUERYINTEGRATEDDISPLAYOUT структурой.

Хотя эта функция обращается к целевому объекту, этот вызов принимает только блокировки адаптера DxgKrnl, а не блокировки дочерних устройств. На практике, так как этот вызов будет выполнен до предоставления доступа к дочернему устройству, не должно быть одновременных вызовов DDI, которые обращаются к одному и тому же целевому объекту.

ПРИМЕЧАНИЕ. В отличие от большинства вызовов QueryAdapterInfo размер выходного буфера является переменным, хотя он по-прежнему известен заранее из поля DescriptorLength структуры DXGK_INTEGRATED_DISPLAY_CHILD для целевого идентификатора. Размер выходного буфера:
DescriptorLength + FIELD_OFFSET( DXGK_QUERYINTEGRATEDDISPLAYOUT, Descriptor ).
DXGKQAITYPE_UEFIFRAMEBUFFERRANGES
Значение: 18
Указывает запрос для диапазонов буфера кадров UEFI. Поддерживается начиная с Windows 10 версии 1703.
DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES
Значение: 19
Поддерживается начиная с Windows 10 версии 1703. Указывает, что запрос на переопределения цветометрии для внешнего дисплея, где входной буфер запроса будет DXGK_QUERYCOLORIMETRYOVERRIDESIN структурой, содержащей только идентификатор целевого объекта, а выходной буфер — DXGK_COLORIMETRY структуру, в которую драйвер записывает переопределения для монитора, присоединенного к целевому объекту.

Хотя эта функция обращается к целевому объекту, этот вызов принимает только блокировки адаптера DxgKrnl, а не блокировки дочерних устройств. Так как этот вызов будет выполнен до предоставления доступа к дочернему устройству, не должно быть параллельных вызовов DDI, которые обращаются к одному и тому же целевому объекту.

Выходной буфер обнуляется при передаче драйверу. Если драйвер не имеет переопределений для монитора, он должен вернуть STATUS_SUCCESS и оставить выходной буфер обнуляемым. Если драйвер имеет переопределения, он заполняет все поля DXGK_COLORIMETRY для описания возможностей монитора, так как ОС не будет принимать частичные переопределения.
DXGKQAITYPE_DISPLAYID_DESCRIPTOR
Значение: 20
Указывает запрос на встроенный дескриптор панели, где входной буфер для запроса будет DXGK_QAITARGETIN структурой, а выходной буфер — DXGK_QUERYINTEGRATEDDISPLAYOUT структурой. Поддерживается с Windows 10 версии 1709.
DXGKQAITYPE_FRAMEBUFFERSAVESIZE
Значение: 21
Драйвер мини-порта дисплея должен заполнять структуру DXGK_FRAMEBUFFERSAVEAREA размером буфера кадров, чтобы сэкономить в системной памяти во время перехода питания. Поддерживается начиная с Windows 10 версии 1803.
DXGKQAITYPE_HARDWARERESERVEDRANGES
Значение: 22
Драйвер мини-порта дисплея должен заполнять структуру DXGK_HARDWARERESERVEDRANGES диапазонами аппаратной зарезервированной памяти. Поддерживается начиная с Windows 10 версии 1803.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2
Значение: 23
Поддерживается начиная с Windows 10 версии 1803. Указывает запрос на встроенный дескриптор панели, где входной буфер запроса будет DXGK_QAITARGETIN структурой, а выходной буфер — DXGK_QUERYINTEGRATEDDISPLAYOUT2 структурой. Этот запрос заменяет использование запроса DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR для драйверов WDDM 2.4.

О дочерних устройствах TypeIntegratedDisplay сообщается путем вызова DxgkDdiQueryAdapterInfo с заданным значением Type.
DXGKQAITYPE_NODEPERFDATA
Значение: 24
Драйвер мини-порта дисплея должен заполнять DXGK_NODE_PERFDATA структуру, которая представляет данные о производительности, собираемые для каждого модуля с адаптера на основе интервала. Поддерживается начиная с Windows 10 версии 1803.
DXGKQAITYPE_ADAPTERPERFDATA
Значение: 25
Драйвер мини-порта дисплея должен заполнять DXGK_ADAPTER_PERFDATA структуру, которая представляет данные о производительности, собираемые для каждого адаптера на основе интервала. Поддерживается начиная с Windows 10 версии 1803.
DXGKQAITYPE_ADAPTERPERFDATA_CAPS
Значение: 26
Драйвер мини-порта дисплея должен заполнять DXGK_ADAPTER_PERFDATACAPS структуру, которая представляет статические возможности данных, которые запрашиваются один раз на GPU во время инициализации. Поддерживается начиная с Windows 10 версии 1803.
DXGKQAITYPE_GPUVERSION
Значение: 27
Драйвер мини-порта дисплея должен заполнить структуру DXGK_GPUVERSION , используемую для сбора версии BIOS и имени архитектуры GPU один раз во время инициализации GPU. Поддерживается начиная с Windows 10 версии 1803.
DXGKQAITYPE_DEVICE_TYPE_CAPS
Значение: 28
Драйвер мини-порта дисплея должен заполнить DXGK_DEVICE_TYPE_CAPS структуру, описывающую тип возможностей устройства. Поддерживается начиная с Windows 10, версия 1809.
DXGKQAITYPE_WDDMDEVICECAPS
Значение: 29
Драйвер мини-порта дисплея должен заполнить структуру DXGK_WDDMDEVICECAPS , которая содержит возможности WDDM, запрашиваемые ОС во время инициализации устройства. Поддерживается с Windows 10 версии 1903.
DXGKQAITYPE_GPUPCAPS
Значение: 30
Драйвер мини-порта дисплея должен заполнять структуру DXGK_GPUPCAPS , которая содержит возможности GPU для драйвера отображения в режиме ядра. Поддерживается с Windows 10 версии 1903.
DXGKQAITYPE_QUERYTARGETGAMMACAPS
Значение: 31
Драйвер мини-порта дисплея должен заполнить DXGK_TARGET_GAMMA_CAPS структуру, описывающую гамма-возможности драйвера минипорта дисплея. Поддерживается с Windows 10 версии 1903.
DXGKQAITYPE_SCANOUT_CAPS
Значение: 33
Драйвер мини-порта дисплея должен заполнить структуру DXGK_QUERY_SCANOUT_CAPS_OUT, описывающую возможности сканирования драйвера. Поддерживается с Windows 10 версии 1903.
DXGKQAITYPE_PHYSICAL_MEMORY_CAPS
Значение: 34
Драйвер мини-порта дисплея должен заполнить DXGK_PHYSICAL_MEMORY_CAPS структуру, описывающую ограничения физической памяти (самый высокий видимый физический адрес) устройства. Поддерживается начиная с Windows Server 2022 (WDDM 2.9).

Дополнительные сведения о том, как указать поддержку драйвера для линейного переназначивания IOMMU, см. в DXGKQAITYPE_IOMMU_CAPS.
DXGKQAITYPE_IOMMU_CAPS
Значение: 35
Драйвер мини-порта дисплея должен заполнить структуру DXGK_IOMMU_CAPS , которая указывает, что драйвер поддерживает линейное переназначение IOMMU. Поддерживается начиная с Windows Server 2022 (WDDM 2.9). Чтобы указать поддержку линейного переназначивания, драйвер должен также сообщить Dxgkernel об ограничениях физической памяти с помощью ограничения DXGKQAITYPE_PHYSICAL_MEMORY_CAPS .

Логическое переназначение можно выполнить только в том случае, если устройство не ссылается на существующую физическую память, поэтому последовательность вызовов Dxgkrnl выглядит следующим образом:

* Вызовите DxgkDdiAddDevice для всех физических адаптеров, чтобы драйвер мог собирать сведения для всех связанных физических адаптеров.

* Вызовите DxgkDdiQueryAdapterInfo с DXGKQAITYPE_PHYSICAL_MEMORY_CAPS и DXGKQAITYPE_IOMMU_CAPS, чтобы затем можно было создать устройство и подключить его к домену IOMMU, прежде чем получить доступ к памяти.

* Вызовите DxgkDdiStartDevice , чтобы запустить устройство.

Комментарии

Dxgkrnl вызывает обратный вызов DxgkDdiQueryAdapterInfo драйвера мини-порта дисплея для получения сведений о конфигурации из графического адаптера. Драйвер заполняет запрошенные сведения в буфере, на который указывает элемент pOutputDataструктуры DXGKARG_QUERYADAPTERINFO . Просмотрите каждое значение перечисления для типа структуры для заполнения.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Верхняя часть d3dkmddi.h (включая D3dkmddi.h)

См. также раздел

DXGKARG_QUERYADAPTERINFO

DxgkDdiQueryAdapterInfo