DXGK_QUERYADAPTERINFOTYPE列舉 (d3dkmddi.h)

  • 發行項

DXGK_QUERYADAPTERINFOTYPE列舉指出呼叫顯示迷你埠驅動程式 DxgkDdiQueryAdapterInfo 函式時要擷取的信息類型。

Syntax

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
顯示迷你埠驅動程序應該會在呼叫 DxgkDdiQueryAdapterInfo 時填入DXGK_POWER_RUNTIME_COMPONENT結構，其中 n是 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 呼叫，輸出緩衝區大小是可變的，不過它仍會事先從 目標標識碼之 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 結構，只包含要尋址的目標標識符，而輸出緩衝區是 DXGK_COLORIMETRY 結構，驅動程式會寫入附加至目標的監視器覆寫。

雖然此函式會解決目標，但只有 DxgKrnl 適配卡鎖定會透過此呼叫來取得，而不是子裝置鎖定。 由於此呼叫會在公開子裝置之前進行，因此不應該有並行的 DDI 呼叫來尋址相同的目標。

當傳遞至驅動程式時，輸出緩衝區會以零。 如果驅動程式沒有監視的覆寫，它應該會傳回STATUS_SUCCESS，並將輸出緩衝區保持零。 如果驅動程式有覆寫，它會填入DXGK_COLORIMETRY的所有欄位，以描述監視功能，因為OS不接受部分覆寫。
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
顯示迷你埠驅動程式應該填入 DXGK_WDDMDEVICECAPS 結構，其中包含作業系統在裝置初始化期間查詢的 WDDM 功能。 從 Windows 10 1903 版開始支援。
DXGKQAITYPE_GPUPCAPS
值： 30
顯示迷你埠驅動程式應該填入 DXGK_GPUPCAPS 結構，其中包含核心模式顯示驅動程式的 GPU 功能。 從 Windows 10 1903 版開始支援。
DXGKQAITYPE_QUERYTARGETGAMMACAPS
值： 31
顯示迷你埠驅動程式應該填入描述顯示迷你埠驅動程式的 gamma 功能 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 (include D3dkmddi.h)

另請參閱

DXGKARG_QUERYADAPTERINFO

DxgkDdiQueryAdapterInfo