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
显示微型端口驱动程序应使用有关第 n个电源组件的信息填充DXGK_POWER_RUNTIME_COMPONENT结构，其中 n 是调用 DxgkDdiQueryAdapterInfo 时由 DXGKARG_QUERYADAPTERINFO.pInputData 指定的组件索引。 从 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 调用不同，输出缓冲区大小是可变的，尽管目标 ID 的 DXGK_INTEGRATED_DISPLAY_CHILD 结构的 DescriptorLength 字段仍预先知道它。输出缓冲区的大小为：
DescriptorLength + FIELD_OFFSET( DXGK_QUERYINTEGRATEDDISPLAYOUT, Descriptor ).
DXGKQAITYPE_UEFIFRAMEBUFFERRANGES
值： 18
指示对 UEFI 帧缓冲区范围的请求。 从 Windows 10 版本 1703 开始受支持。
DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES
值： 19
从 Windows 10 版本 1703 开始受支持。 指示对外部显示器的色度替代请求，其中查询的输入缓冲区将是 DXGK_QUERYCOLORIMETRYOVERRIDESIN 结构，仅包含要寻址的目标 ID，输出缓冲区是驱动程序将附加到目标的监视器的替代写入 到的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 结构。 此查询取代了 WDDM 2.4 驱动程序 的 DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR 查询的使用。

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
显示微型端口驱动程序应在 GPU 初始化期间填充一个用于收集 BIOS 版本和 GPU 体系结构名称的 DXGK_GPUVERSION 结构。 从 Windows 10 版本 1803 开始受支持。
DXGKQAITYPE_DEVICE_TYPE_CAPS
值： 28
显示微型端口驱动程序应填充描述设备功能类型的 DXGK_DEVICE_TYPE_CAPS 结构。 从 Windows 10 版本 1809 开始支持。
DXGKQAITYPE_WDDMDEVICECAPS
值： 29
显示微型端口驱动程序应填充包含 OS 在设备初始化期间查询的 WDDM 功能的 DXGK_WDDMDEVICECAPS 结构。 从 Windows 10 版本 1903 开始受支持。
DXGKQAITYPE_GPUPCAPS
值： 30
显示微型端口驱动程序应填充包含内核模式显示驱动程序的 GPU 功能的 DXGK_GPUPCAPS 结构。 从 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) 开始受支持。 若要指示支持线性重新映射，驱动程序还必须通过DXGKQAITYPE_PHYSICAL_MEMORY_CAPS上限通知 Dxgkernel 其物理内存限制。

仅当设备未引用任何现有物理内存时，才能执行逻辑重新映射，因此 Dxgkrnl 的调用顺序如下所示：

* 为所有物理适配器调用 DxgkDdiAddDevice ，以便驱动程序可以收集所有链接的物理适配器的信息。

* 使用 DXGKQAITYPE_PHYSICAL_MEMORY_CAPS 和 DXGKQAITYPE_IOMMU_CAPS 调用 DxgkDdiQueryAdapterInfo ，以便在访问任何内存之前创建设备并将其附加到 IOMMU 域。

* 调用 DxgkDdiStartDevice 以启动设备。

注解

Dxgkrnl 调用显示微型端口驱动程序的 DxgkDdiQueryAdapterInfo 回调，以从图形适配器检索配置信息。 驱动程序在 DXGKARG_QUERYADAPTERINFO 结构的 pOutputData 成员指向的缓冲区中填充请求的信息。 查看要填充的结构类型的每个枚举值。

要求

要求 值
最低受支持的客户端 Windows Vista
标头 d3dkmddi.h (包括 D3dkmddi.h)

另请参阅

DXGKARG_QUERYADAPTERINFO

DxgkDdiQueryAdapterInfo