DXGK_QUERYADAPTERINFOTYPE-Enumeration (d3dkmddi.h)

  • Artikel

Die DXGK_QUERYADAPTERINFOTYPE-Enumeration gibt den Typ der Informationen an, die abgerufen werden sollen, wenn die DxgkDdiQueryAdapterInfo-Funktion eines Anzeigeminiporttreibers aufgerufen wird.

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;

Konstanten

 
DXGKQAITYPE_UMDRIVERPRIVATE
Wert: 0
Gibt eine private, proprietäre Datenstruktur für den Anzeigetreiber an.
DXGKQAITYPE_DRIVERCAPS
Wert: 1
Der Anzeigeminiporttreiber sollte eine DXGK_DRIVERCAPS Struktur mit seinen Treiberfunktionen auffüllen.
DXGKQAITYPE_QUERYSEGMENT
Wert: 2
Der Anzeigeminiporttreiber sollte eine DXGK_QUERYSEGMENTOUT Struktur mit seinen Speichersegmentinformationen auffüllen.
DXGKQAITYPE_RESERVED
Wert: 3
Ist für das System reserviert. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante tritt ab Windows 7 auf.
DXGKQAITYPE_QUERYSEGMENT2
Wert: 4
Ist für das System reserviert. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante tritt ab Windows 7 auf.
DXGKQAITYPE_QUERYSEGMENT3
Wert: 5
Der Anzeigeminiporttreiber sollte eine DXGK_QUERYSEGMENTOUT3 Struktur mit Speichersegmentinformationen auffüllen. Wird ab Windows 8 unterstützt.
DXGKQAITYPE_NUMPOWERCOMPONENTS
Wert: 6
Der Anzeigeminiport sollte einen UINT-Wert bereitstellen, der die Anzahl der von ihr verwendeten Energiekomponenten angibt. Wird ab Windows 8 unterstützt.
DXGKQAITYPE_POWERCOMPONENTINFO
Wert: 7
Der Anzeigeminiporttreiber sollte eine DXGK_POWER_RUNTIME_COMPONENT-Struktur mit Informationen über die n-th-Energiekomponente auffüllen, wobei n der Von DXGKARG_QUERYADAPTERINFO.pInputData in einem Aufruf von DxgkDdiQueryAdapterInfo angegebene Komponentenindex ist. Wird ab Windows 8 unterstützt.
DXGKQAITYPE_PREFERREDGPUNODE
Wert: 8
Ist für das System reserviert. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante tritt ab Windows 8 auf.
DXGKQAITYPE_POWERCOMPONENTPSTATEINFO
Wert: 9
Ist für das System reserviert. Verwenden Sie nicht in Ihrem Treiber. Wird ab Windows 8.1 unterstützt.
DXGKQAITYPE_HISTORYBUFFERPRECISION
Wert: 10
Der Anzeigeminiporttreiber sollte eine DXGKARG_HISTORYBUFFERPRECISION Struktur mit Informationen zur Genauigkeit der verwendeten Verlaufspufferdaten auffüllen. Wird ab Windows 8.1 unterstützt.
DXGKQAITYPE_QUERYSEGMENT4
Wert: 11
Der Anzeigeminiporttreiber sollte eine DXGK_QUERYSEGMENTOUT4 Struktur auffüllen, um seine Speichersegmentinformationen anzugeben. Wird ab Windows 10 unterstützt.
DXGKQAITYPE_SEGMENTMEMORYSTATE
Wert: 12
Der Anzeigeminiporttreiber sollte eine DXGK_MEMORYRANGE-Struktur mit den fehlerhaften Speicherbereichen auffüllen. Wird ab Windows 10 unterstützt.
DXGKQAITYPE_GPUMMUCAPS
Wert: 13
Der Anzeigeminiporttreiber sollte eine DXGK_GPUMMUCAPS-Struktur mit seinen Funktionen für die Verwaltung des virtuellen Speichers auffüllen. Wird ab Windows 10 unterstützt.
DXGKQAITYPE_PAGETABLELEVELDESC
Wert: 14
Ist für das System reserviert. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante tritt ab Windows 10 auf.
DXGKQAITYPE_PHYSICALADAPTERCAPS
Wert: 15
Ist für das System reserviert. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante tritt ab Windows 10 auf.
DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION
Wert: 16
Ist für das System reserviert. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante tritt ab Windows 10 auf.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR
Wert: 17
Wird ab Windows 10 Version 1703 unterstützt. Gibt eine Anforderung für einen integrierten Bereichsdeskriptor an, bei dem der Eingabepuffer für die Abfrage eine DXGK_QUERYINTEGRATEDDISPLAYIN-Struktur und der Ausgabepuffer eine DXGK_QUERYINTEGRATEDDISPLAYOUT-Struktur ist.

Obwohl diese Funktion ein Ziel adressiert, werden nur DxgKrnl-Adaptersperren für diesen Aufruf übernommen, nicht untergeordnete Gerätesperren. In der Praxis sollte es keine gleichzeitigen DDI-Aufrufe geben, die dasselbe Ziel adressieren, da dieser Aufruf erfolgt, bevor das untergeordnete Gerät verfügbar gemacht wird.

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

Obwohl diese Funktion ein Ziel adressiert, werden nur DxgKrnl-Adaptersperren für diesen Aufruf übernommen, nicht untergeordnete Gerätesperren. Da dieser Aufruf erfolgt, bevor das untergeordnete Gerät verfügbar gemacht wird, sollte es keine gleichzeitigen DDI-Aufrufe geben, die dasselbe Ziel adressieren.

Der Ausgabepuffer wird auf Null gesetzt, wenn er an den Treiber übergeben wird. Wenn der Treiber keine Außerkraftsetzungen für den Monitor aufweist, sollte er STATUS_SUCCESS zurückgeben und den Ausgabepuffer auf null setzen. Wenn der Treiber Überschreibungen aufweist, füllen Sie 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 Bereichsdeskriptor an, bei dem der Eingabepuffer für die Abfrage eine DXGK_QAITARGETIN-Struktur und der Ausgabepuffer eine DXGK_QUERYINTEGRATEDDISPLAYOUT-Struktur ist. Unterstützt ab Windows 10 Version 1709.
DXGKQAITYPE_FRAMEBUFFERSAVESIZE
Wert: 21
Der Anzeigeminiporttreiber sollte eine DXGK_FRAMEBUFFERSAVEAREA Struktur mit der Größe des Framepuffers auffüllen, die bei Energieübergängen im Systemspeicher gespeichert werden soll. Wird ab Windows 10 Version 1803 unterstützt.
DXGKQAITYPE_HARDWARERESERVEDRANGES
Wert: 22
Der Display-Miniporttreiber sollte eine DXGK_HARDWARERESERVEDRANGES Struktur mit den reservierten Hardwarespeicherbereichen auffüllen. Wird ab Windows 10 Version 1803 unterstützt.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2
Wert: 23
Wird ab Windows 10 Version 1803 unterstützt. Gibt eine Anforderung für einen integrierten Bereichsdeskriptor an, bei dem der Eingabepuffer für die Abfrage eine DXGK_QAITARGETIN-Struktur 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 untergeordnete Geräte werden gemeldet, indem DxgkDdiQueryAdapterInfo aufgerufen wird, wobei der Typ auf diesen Wert festgelegt ist.
DXGKQAITYPE_NODEPERFDATA
Wert: 24
Der Anzeigeminiporttreiber sollte eine DXGK_NODE_PERFDATA-Struktur auffüllen, die leistungsbasierte Leistungsdaten darstellt, die pro Engine von einem Adapter auf Intervallbasis erfasst werden. Wird ab Windows 10 Version 1803 unterstützt.
DXGKQAITYPE_ADAPTERPERFDATA
Wert: 25
Der Anzeigeminiporttreiber sollte eine DXGK_ADAPTER_PERFDATA Struktur auffüllen, die leistungsbasierte Daten pro Adapter auf Intervallbasis darstellt. Wird ab Windows 10 Version 1803 unterstützt.
DXGKQAITYPE_ADAPTERPERFDATA_CAPS
Wert: 26
Der Anzeigeminiporttreiber sollte eine DXGK_ADAPTER_PERFDATACAPS Struktur auffüllen, die Datenfunktionen darstellt, die statisch sind und einmal pro GPU während der Initialisierung abgefragt werden. Wird ab Windows 10 Version 1803 unterstützt.
DXGKQAITYPE_GPUVERSION
Wert: 27
Der Display-Miniporttreiber sollte eine DXGK_GPUVERSION Struktur auffüllen , die zum Erfassen der BIOS-Version und des GPU-Architekturnamens einmal während der GPU-Initialisierung verwendet wird. Wird ab Windows 10 Version 1803 unterstützt.
DXGKQAITYPE_DEVICE_TYPE_CAPS
Wert: 28
Der Anzeigeminiporttreiber sollte eine DXGK_DEVICE_TYPE_CAPS Struktur auffüllen, die den Typ der Funktionen für ein Gerät beschreibt. Wird ab Windows 10, Version 1809 unterstützt.
DXGKQAITYPE_WDDMDEVICECAPS
Wert: 29
Der Anzeigeminiporttreiber sollte eine DXGK_WDDMDEVICECAPS-Struktur auffüllen, die die WDDM-Funktionen enthält, die während der Geräteinitialisierung vom Betriebssystem abgefragt werden. Wird ab Windows 10 Version 1903 unterstützt.
DXGKQAITYPE_GPUPCAPS
Wert: 30
Der Anzeigeminiporttreiber sollte eine DXGK_GPUPCAPS Struktur auffüllen, die die GPU-Funktionen für einen Kernelmodusanzeigetreiber enthält. Wird ab Windows 10 Version 1903 unterstützt.
DXGKQAITYPE_QUERYTARGETGAMMACAPS
Wert: 31
Der Display-Miniporttreiber sollte eine DXGK_TARGET_GAMMA_CAPS Struktur auffüllen, die die Gammafunktionen des Anzeigeminiporttreibers beschreibt. Wird ab Windows 10 Version 1903 unterstützt.
DXGKQAITYPE_SCANOUT_CAPS
Wert: 33
Der Anzeigeminiporttreiber sollte eine DXGK_QUERY_SCANOUT_CAPS_OUT Struktur auffüllen, die die Scanoutfunktionen des Treibers beschreibt. Wird ab Windows 10 Version 1903 unterstützt.
DXGKQAITYPE_PHYSICAL_MEMORY_CAPS
Wert: 34
Der Anzeigeminiporttreiber sollte eine DXGK_PHYSICAL_MEMORY_CAPS Struktur auffüllen, die die Physischen Speichereinschränkungen (die höchste sichtbare physische Adresse) des Geräts beschreibt. Wird ab Windows Server 2022 (WDDM 2.9) unterstützt.

Weitere Informationen zum Angeben der Treiberunterstützung für die lineare IOMMU-Neuzuordnung finden Sie unter DXGKQAITYPE_IOMMU_CAPS .
DXGKQAITYPE_IOMMU_CAPS
Wert: 35
Der Anzeigeminiporttreiber 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 Dxgkernel auch über die Einschränkungen des physischen Arbeitsspeichers über die DXGKQAITYPE_PHYSICAL_MEMORY_CAPS-Obergrenze informieren.

Die logische Neuzuordnung kann nur durchgeführt werden, wenn vom Gerät kein vorhandener physischer Arbeitsspeicher referenziert wird, sodass die Anrufsequenz von Dxgkrnl wie folgt lautet:

* 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 das Gerät dann erstellen und an eine IOMMU-Domäne angefügt werden kann, bevor auf arbeitsspeicher zugegriffen werden kann.

* Rufen Sie DxgkDdiStartDevice auf, um das Gerät zu starten.

Hinweise

Dxgkrnl ruft den DxgkDdiQueryAdapterInfo-Rückruf des Anzeigeminiporttreibers auf, um Konfigurationsinformationen vom Grafikkarten abzurufen. Der Treiber füllt die angeforderten Informationen im Puffer aus, auf den das pOutputData-Element der DXGKARG_QUERYADAPTERINFO-Struktur verweist. Sehen Sie sich die einzelnen Enumerationswerte für den Typ der zu füllenden Struktur an.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Kopfzeile d3dkmddi.h (einschließlich D3dkmddi.h)

Weitere Informationen

DXGKARG_QUERYADAPTERINFO

DxgkDdiQueryAdapterInfo