Freigeben über

DXGK_QUERYADAPTERINFOTYPE Enumeration (d3dkmddi.h)

  • Artikel

Die DXGK_QUERYADAPTERINFOTYPE Enumeration gibt den Informationstyp an, den der Kernelmodus-Miniporttreiber (KMD) im Puffer zurückgeben soll, auf den pOutputData verweist, wenn die DxgkDdiQueryAdapterInfo Funktion aufgerufen wird. Details zu den Typen, die Eingabe erfordern (pInputData), finden Sie unter DXGKARG_QUERYADAPTERINFO).

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 = 36,
  DXGKQAITYPE_NATIVE_FENCE_CAPS = 37,
  DXGKQAITYPE_USERMODESUBMISSION_CAPS = 38,
  DXGKQAITYPE_DIRTYBITTRACKINGCAPS = 39,
  DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPS = 40,
  DXGKQAITYPE_SCATTER_RESERVE = 41,
  DXGKQAITYPE_QUERYPAGINGBUFFERINFO = 42,
  DXGKQAITYPE_QUERYSEGMENTCOUNT = 43,
  DXGKQAITYPE_QUERYSEGMENT5 = 44,
  DXGKQAITYPE_QUERYMMUCOUNT = 45,
  DXGKQAITYPE_QUERYMMUS = 46,
  DXGKQAITYPE_64BITONLYCAPS = 47,
  DXGKQAITYPE_PAGINGPROCESSGPUVASIZE = 48
} DXGK_QUERYADAPTERINFOTYPE;

Konstanten

 
DXGKQAITYPE_UMDRIVERPRIVATE
Wert: 0
Gibt eine private, proprietäre Datenstruktur für den Anzeigetreiber an.
DXGKQAITYPE_DRIVERCAPS
Wert: 1
Die KMD sollte eine DXGK_DRIVERCAPS Struktur mit ihren Treiberfunktionen auffüllen.
DXGKQAITYPE_QUERYSEGMENT
Wert: 2
Die KMD sollte eine DXGK_QUERYSEGMENTOUT Struktur mit ihren Speichersegmentinformationen auffüllen.
DXGKQAITYPE_RESERVED
Wert: 3
Reserviert für die Systemverwendung. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante tritt ab Windows 7 auf.
DXGKQAITYPE_QUERYSEGMENT2
Wert: 4
Reserviert für die Systemverwendung. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante tritt ab Windows 7 auf.
DXGKQAITYPE_QUERYSEGMENT3
Wert: 5
Die KMD sollte eine DXGK_QUERYSEGMENTOUT3 Struktur mit Speichersegmentinformationen auffüllen. Wird ab Windows 8 unterstützt.
DXGKQAITYPE_NUMPOWERCOMPONENTS
Wert: 6
Der Miniport für die Anzeige sollte einen UINT-Wert bereitstellen, der die Anzahl der von ihr verbrauchten Energiekomponenten angibt. Wird ab Windows 8 unterstützt.
DXGKQAITYPE_POWERCOMPONENTINFO
Wert: 7
Die KMD sollte eine DXGK_POWER_RUNTIME_COMPONENT Struktur mit Informationen über die nth-Energiekomponente auffüllen, wobei n der durch DXGKARG_QUERYADAPTERINFO.pInputData- in einem Aufruf von DxgkDdiQueryAdapterInfoangegebene Komponentenindex ist. Wird ab Windows 8 unterstützt.
DXGKQAITYPE_PREFERREDGPUNODE
Wert: 8
Reserviert für die Systemverwendung. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante beginnt in Windows 8.
DXGKQAITYPE_POWERCOMPONENTPSTATEINFO
Wert: 9
Reserviert für die Systemverwendung. Verwenden Sie nicht in Ihrem Treiber. Wird ab Windows 8.1 unterstützt.
DXGKQAITYPE_HISTORYBUFFERPRECISION
Wert: 10
Der KMD sollte eine DXGKARG_HISTORYBUFFERPRECISION Struktur mit Informationen zur Genauigkeit der von ihr verwendeten Verlaufspufferdaten auffüllen. Wird ab Windows 8.1 unterstützt.
DXGKQAITYPE_QUERYSEGMENT4
Wert: 11
Die KMD sollte eine DXGK_QUERYSEGMENTOUT4 Struktur auffüllen, um die Speichersegmentinformationen anzugeben. Wird ab Windows 10 unterstützt.
DXGKQAITYPE_SEGMENTMEMORYSTATE
Wert: 12
Die KMD sollte eine DXGK_MEMORYRANGE Struktur mit ihren ungültigen Speicherbereichen auffüllen. Wird ab Windows 10 unterstützt.
DXGKQAITYPE_GPUMMUCAPS
Wert: 13
Die KMD sollte eine DXGK_GPUMMUCAPS Struktur mit ihren funktionen für die Verwaltung virtueller Speicher auffüllen. Wird ab Windows 10 unterstützt.
DXGKQAITYPE_PAGETABLELEVELDESC
Wert: 14
Reserviert für die Systemverwendung. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante beginnt in Windows 10.
DXGKQAITYPE_PHYSICALADAPTERCAPS
Wert: 15
Reserviert für die Systemverwendung. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante beginnt in Windows 10.
DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION
Wert: 16
Reserviert für die Systemverwendung. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante beginnt in Windows 10.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR
Wert: 17
Unterstützt ab Windows 10, Version 1703. Gibt eine Anforderung für einen integrierten Paneldeskriptor an, bei dem der Eingabepuffer für die Abfrage eine DXGK_QUERYINTEGRATEDDISPLAYIN Struktur ist und der Ausgabepuffer eine DXGK_QUERYINTEGRATEDDISPLAYOUT Struktur ist.

Obwohl diese Funktion ein Ziel adressiert, werden nur DxgKrnl-Adaptersperren über diesen Aufruf übernommen, nicht untergeordnete Gerätesperren. Da dieser Aufruf ausgeführt wird, bevor das untergeordnete Gerät verfügbar gemacht wird, sollten keine gleichzeitigen DDI-Aufrufe vorhanden sein, die dasselbe Ziel adressieren.

HINWEIS: Im Gegensatz zu den meisten QueryAdapterInfo-Aufrufen ist die Ausgabepuffergröße variable, obwohl sie im Voraus aus dem Feld "DescriptorLength" der DXGK_INTEGRATED_DISPLAY_CHILD Struktur für die Ziel-ID bekannt ist. Die Größe des Ausgabepuffers lautet:
DescriptorLength + FIELD_OFFSET( DXGK_QUERYINTEGRATEDDISPLAYOUT, Descriptor ).
DXGKQAITYPE_UEFIFRAMEBUFFERRANGES
Wert: 18
Gibt die Anforderung für die UEFI-Framepufferbereiche an. Unterstützt ab Windows 10, Version 1703.
DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES
Wert: 19
Unterstützt ab Windows 10, Version 1703. Gibt eine Anforderung für Farbmetrieüberschreibungen für eine externe Anzeige an, wobei der Eingabepuffer für die Abfrage eine DXGK_QUERYCOLORIMETRYOVERRIDESIN Struktur ist, die nur die Ziel-ID enthält, die adressiert wird, und der Ausgabepuffer ist eine DXGK_COLORIMETRY Struktur, in die der Treiber Außerkraftsetzungen für den Monitor schreibt, der an das Ziel angefügt ist.

Obwohl diese Funktion ein Ziel adressiert, werden nur DxgKrnl-Adaptersperren über diesen Aufruf übernommen, nicht untergeordnete Gerätesperren. Da dieser Aufruf ausgeführt wird, bevor das untergeordnete Gerät verfügbar gemacht wird, sollten keine gleichzeitigen DDI-Aufrufe vorhanden sein, die dasselbe Ziel adressieren.

Der Ausgabepuffer ist null, wenn er an den Treiber übergeben wird. Wenn der Treiber keine Außerkraftsetzungen für den Monitor hat, sollte er STATUS_SUCCESS zurückgeben und den Ausgabepuffer null lassen. Wenn der Treiber Außerkraftsetzungen aufweist, füllt er alle Felder des DXGK_COLORIMETRY aus, um die Monitorfunktionen zu beschreiben, da das Betriebssystem keine teilweisen Außerkraftsetzungen akzeptiert.
DXGKQAITYPE_DISPLAYID_DESCRIPTOR
Wert: 20
Gibt eine Anforderung für einen integrierten Paneldeskriptor an, bei dem der Eingabepuffer für die Abfrage eine DXGK_QAITARGETIN Struktur ist und der Ausgabepuffer eine DXGK_QUERYINTEGRATEDDISPLAYOUT Struktur ist. Unterstützt ab Windows 10, Version 1709.
DXGKQAITYPE_FRAMEBUFFERSAVESIZE
Wert: 21
Der KMD sollte eine DXGK_FRAMEBUFFERSAVEAREA Struktur mit der Größe des Framepuffers auffüllen, um den Systemspeicher während der Stromübergänge zu speichern. Unterstützt ab Windows 10, Version 1803.
DXGKQAITYPE_HARDWARERESERVEDRANGES
Wert: 22
Die KMD sollte eine DXGK_HARDWARERESERVEDRANGES Struktur mit den hardware reservierten Speicherbereichen auffüllen. Unterstützt ab Windows 10, Version 1803.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2
Wert: 23
Unterstützt ab Windows 10, Version 1803. Gibt eine Anforderung für einen integrierten Paneldeskriptor an, bei dem der Eingabepuffer für die Abfrage eine DXGK_QAITARGETIN Struktur ist und der Ausgabepuffer eine DXGK_QUERYINTEGRATEDDISPLAYOUT2 Struktur ist. Diese Abfrage ersetzt die Verwendung der DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR Abfrage für WDDM 2.4-Treiber.

TypeIntegratedDisplay- untergeordneten Geräte werden durch Aufrufen DxgkDdiQueryAdapterInfo mit dem auf diesen Wert festgelegten Type gemeldet.
DXGKQAITYPE_NODEPERFDATA
Wert: 24
Der KMD sollte eine DXGK_NODE_PERFDATA Struktur auffüllen, die Leistungsdaten darstellt, die pro Modul auf Intervallbasis von einem Adapter gesammelt werden. Unterstützt ab Windows 10, Version 1803.
DXGKQAITYPE_ADAPTERPERFDATA
Wert: 25
Die KMD sollte eine DXGK_ADAPTER_PERFDATA Struktur auffüllen, die Leistungsdaten darstellt, die pro Adapter auf Intervallbasis gesammelt werden. Unterstützt ab Windows 10, Version 1803.
DXGKQAITYPE_ADAPTERPERFDATA_CAPS
Wert: 26
Die KMD sollte eine DXGK_ADAPTER_PERFDATACAPS Struktur auffüllen, die Datenfunktionen darstellt, die während der Initialisierung einmal pro GPU statisch und abgefragt werden. Unterstützt ab Windows 10, Version 1803.
DXGKQAITYPE_GPUVERSION
Wert: 27
Die KMD sollte eine DXGK_GPUVERSION Struktur auffüllen, die verwendet wird, um die BIOS-Version und den GPU-Architekturnamen einmal während der GPU-Initialisierung zu erfassen. Unterstützt ab Windows 10, Version 1803.
DXGKQAITYPE_DEVICE_TYPE_CAPS
Wert: 28
Die KMD sollte eine DXGK_DEVICE_TYPE_CAPS Struktur auffüllen, die den Typ der Funktionen für ein Gerät beschreibt. Unterstützt ab Windows 10, Version 1809.
DXGKQAITYPE_WDDMDEVICECAPS
Wert: 29
Der KMD sollte eine DXGK_WDDMDEVICECAPS Struktur auffüllen, die die WDDM-Funktionen enthält, die während der Geräteinitialisierung vom Betriebssystem abgefragt werden. Unterstützt ab Windows 10, Version 1903.
DXGKQAITYPE_GPUPCAPS
Wert: 30
Die KMD sollte eine DXGK_GPUPCAPS Struktur auffüllen, die die GPU-Funktionen für einen Kernelmodusanzeigetreiber enthält. Unterstützt ab Windows 10, Version 1903.
DXGKQAITYPE_QUERYTARGETGAMMACAPS
Wert: 31
Der KMD sollte eine DXGK_TARGET_GAMMA_CAPS Struktur auffüllen, die die Gammafunktionen der KMD beschreibt. Unterstützt ab Windows 10, Version 1903.
DXGKQAITYPE_SCANOUT_CAPS
Wert: 33
Die KMD sollte eine DXGK_QUERY_SCANOUT_CAPS_OUT Struktur auffüllen, die die Scanoutfunktionen des Treibers beschreibt. Unterstützt ab Windows 10, Version 1903.
DXGKQAITYPE_PHYSICAL_MEMORY_CAPS
Wert: 34
Der KMD sollte eine DXGK_PHYSICAL_MEMORY_CAPS Struktur auffüllen, die die physischen Speicherbeschränkungen (die höchste sichtbare physische Adresse) des Geräts beschreibt. Wird ab Windows Server 2022 (WDDM 2.9) unterstützt.

Ausführliche Informationen zum Angeben der Treiberunterstützung für die lineare Neuzuordnung von IOMMU finden Sie unter DXGKQAITYPE_IOMMU_CAPS.
DXGKQAITYPE_IOMMU_CAPS
Wert: 35
Die KMD sollte eine DXGK_IOMMU_CAPS Struktur auffüllen, die angibt, dass die lineare IOMMU-Neuzuordnung vom Treiber unterstützt wird. Wird ab Windows Server 2022 (WDDM 2.9) unterstützt. Um die Unterstützung für die lineare Neuzuordnung anzugeben, muss der Treiber auch Dxgkernel über seine physischen Speichereinschränkungen über die DXGKQAITYPE_PHYSICAL_MEMORY_CAPS Cap informieren.

Die logische Neuzuordnung kann nur erfolgen, wenn kein vorhandener physischer Speicher vom Gerät referenziert wird. Daher lautet DxgkrnlAufrufsequenz wie folgt:

* Rufen Sie DxgkDdiAddDevice- für alle physischen Adapter auf, damit der Treiber Informationen für alle verknüpften physischen Adapter sammeln kann.

* Rufen Sie DxgkDdiQueryAdapterInfo mit DXGKQAITYPE_PHYSICAL_MEMORY_CAPS und DXGKQAITYPE_IOMMU_CAPS auf, damit es das Gerät dann erstellen und an eine IOMMU-Domäne anfügen kann, bevor auf einen Speicher zugegriffen werden kann.

* Rufen Sie DxgkDdiStartDevice auf, um das Gerät zu starten.
DXGKQAITYPE_HARDWARERESERVEDRANGES2
Wert: 36
DXGKQAITYPE_NATIVE_FENCE_CAPS
Wert: 37
Die KMD sollte eine DXGK_NATIVE_FENCE_CAPS Struktur auffüllen, die die Supportdetails des Treibers für systemeigene GPU-Zäune enthält. Unterstützt ab Windows 11, Version 24H2. Weitere Informationen finden Sie unter native GPU-Zäune.
DXGKQAITYPE_USERMODESUBMISSION_CAPS
Wert: 38
Die KMD sollte eine DXGK_USERMODESUBMISSION_CAPS Struktur auffüllen, die die Supportdetails des Treibers für die Übermittlung im Benutzermodus enthält. Unterstützt ab Windows 11, Version 24H2. Weitere Informationen finden Sie unter Arbeitsübermittlung im Benutzermodus.
DXGKQAITYPE_DIRTYBITTRACKINGCAPS
Wert: 39
Die KMD sollte eine DXGK_DIRTY_BIT_TRACKING_CAPS Struktur auffüllen, die die Supportdetails des Treibers für die schmutzige Bitnachverfolgung enthält. Unterstützt ab Windows 11, Version 24H2. Weitere Informationen finden Sie unter Dirty Bit Tracking.
DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPS
Wert: 40
Die KMD sollte eine DXGK_DIRTY_BIT_TRACKING_SEGMENT_CAPS Struktur auffüllen, die die Supportdetails des Treibers für die Nachverfolgung von schmutzigen Bits für ein bestimmtes Speichersegment enthält. Unterstützt ab Windows 11, Version 24H2. Weitere Informationen finden Sie unter Dirty Bit Tracking.
DXGKQAITYPE_SCATTER_RESERVE
Wert: 41
Die KMD sollte eine DXGK_QUERYSCATTERRESERVEOUT Struktur auffüllen, die die Supportdetails des Treibers für punktierte Reserve enthält. Unterstützt ab Windows 11, Version 24H2. Weitere Informationen finden Sie unter Livemigration auf GPU-P Geräten.
DXGKQAITYPE_QUERYPAGINGBUFFERINFO
Wert: 42
DXGKQAITYPE_QUERYSEGMENTCOUNT
Wert: 43
DXGKQAITYPE_QUERYSEGMENT5
Wert: 44
DXGKQAITYPE_QUERYMMUCOUNT
Wert: 45
DXGKQAITYPE_QUERYMMUS
Wert: 46
DXGKQAITYPE_64BITONLYCAPS
Wert: 47
DXGKQAITYPE_PAGINGPROCESSGPUVASIZE
Wert: 48
KMD sollte die Größe des GPU VA-Speicherplatzes des Pagingprozesses in Megabyte zurückgeben. Weitere Informationen finden Sie unter Zuordnungsbenachrichtigung. Verfügbar ab Windows 11, Version 24H2 (WDDM 3.2).

Bemerkungen

Dxgkrnl- ruft die DxgkDdiQueryAdapterInfo Rückruf der KMD auf, um Konfigurationsinformationen vom Grafikadapter abzurufen. Der Treiber füllt die angeforderten Informationen im Puffer aus, auf die durch das pOutputData- Element der DXGKARG_QUERYADAPTERINFO-Struktur verwiesen wird. Sehen Sie sich jeden Enumerationswert für den Typ der struktur an, die ausgefüllt werden soll.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista
Header- d3dkmddi.h (einschließlich D3dkmddi.h)

Siehe auch

DXGKARG_QUERYADAPTERINFO

DxgkDdiQueryAdapterInfo