DXGK_QUERYADAPTERINFOTYPE-Enumeration (d3dkmddi.h)
Die DXGK_QUERYADAPTERINFOTYPE-Enumeration gibt den Typ der Informationen an, die der Kernelmodusanzeige-Miniporttreiber (KMD) in dem Puffer zurückgeben soll, auf den pOutputData zeigt, wenn seine DxgkDdiQueryAdapterInfo-Funktion aufgerufen wird. Weitere Informationen zu den Typen, die eine 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,
DXGKQAITYPE_QUERYSEGMENTCOUNT,
DXGKQAITYPE_QUERYSEGMENT5,
DXGKQAITYPE_QUERYMMUCOUNT,
DXGKQAITYPE_QUERYMMUS,
DXGKQAITYPE_64BITONLYCAPS,
DXGKQAITYPE_PAGINGPROCESSGPUVASIZE
} DXGK_QUERYADAPTERINFOTYPE;
Konstanten
DXGKQAITYPE_UMDRIVERPRIVATEWert: 0 Gibt eine private, proprietäre Datenstruktur für den Anzeigetreiber an. |
DXGKQAITYPE_DRIVERCAPSWert: 1 Der KMD sollte eine DXGK_DRIVERCAPS-Struktur mit ihren Treiberfunktionen auffüllen. |
DXGKQAITYPE_QUERYSEGMENTWert: 2 Der KMD sollte eine DXGK_QUERYSEGMENTOUT-Struktur mit ihren Speichersegmentinformationen auffüllen. |
DXGKQAITYPE_RESERVEDWert: 3 Ist für das System reserviert. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante tritt ab Windows 7 auf. |
DXGKQAITYPE_QUERYSEGMENT2Wert: 4 Ist für das System reserviert. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante tritt ab Windows 7 auf. |
DXGKQAITYPE_QUERYSEGMENT3Wert: 5 Die KMD sollte eine DXGK_QUERYSEGMENTOUT3-Struktur mit Speichersegmentinformationen auffüllen. Unterstützt ab Windows 8. |
DXGKQAITYPE_NUMPOWERCOMPONENTSWert: 6 Der Anzeige-Miniport sollte einen UINT-Wert bereitstellen, der die Anzahl der Energiekomponenten angibt, die er verwendet. Unterstützt ab Windows 8. |
DXGKQAITYPE_POWERCOMPONENTINFOWert: 7 Der KMD sollte eine DXGK_POWER_RUNTIME_COMPONENT-Struktur mit Informationen über die n-th-Energiekomponente auffüllen, wobei n der Komponentenindex ist, der von DXGKARG_QUERYADAPTERINFO.pInputData in einem Aufruf von DxgkDdiQueryAdapterInfo angegeben wird. Unterstützt ab Windows 8. |
DXGKQAITYPE_PREFERREDGPUNODEWert: 8 Ist für das System reserviert. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante tritt ab Windows 8 auf. |
DXGKQAITYPE_POWERCOMPONENTPSTATEINFOWert: 9 Ist für das System reserviert. Verwenden Sie nicht in Ihrem Treiber. Unterstützt ab Windows 8.1. |
DXGKQAITYPE_HISTORYBUFFERPRECISIONWert: 10 Die KMD sollte eine DXGKARG_HISTORYBUFFERPRECISION-Struktur mit Informationen über die Genauigkeit der verwendeten Verlaufspufferdaten auffüllen. Unterstützt ab Windows 8.1. |
DXGKQAITYPE_QUERYSEGMENT4Wert: 11 Die KMD sollte eine DXGK_QUERYSEGMENTOUT4 Struktur auffüllen, um die Informationen zu den Speichersegmenten anzugeben. Unterstützt ab Windows 10. |
DXGKQAITYPE_SEGMENTMEMORYSTATEWert: 12 Die KMD sollte eine DXGK_MEMORYRANGE-Struktur mit ihren fehlerhaften Speicherbereichen auffüllen. Unterstützt ab Windows 10. |
DXGKQAITYPE_GPUMMUCAPSWert: 13 Die KMD sollte eine DXGK_GPUMMUCAPS-Struktur mit ihren Funktionen zur Verwaltung des virtuellen Speichers auffüllen. Unterstützt ab Windows 10. |
DXGKQAITYPE_PAGETABLELEVELDESCWert: 14 Ist für das System reserviert. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante tritt ab Windows 10 auf. |
DXGKQAITYPE_PHYSICALADAPTERCAPSWert: 15 Ist für das System reserviert. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante tritt ab Windows 10 auf. |
DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSIONWert: 16 Ist für das System reserviert. Verwenden Sie nicht in Ihrem Treiber. Diese Konstante tritt ab Windows 10 auf. |
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTORWert: 17 Unterstützt ab Windows 10 Version 1703. 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 Größe des Ausgabepuffers variabel, 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 ist: DescriptorLength + FIELD_OFFSET( DXGK_QUERYINTEGRATEDDISPLAYOUT, Descriptor ). |
DXGKQAITYPE_UEFIFRAMEBUFFERRANGESWert: 18 Gibt die Anforderung für die UEFI-Framepufferbereiche an. Unterstützt ab Windows 10 Version 1703. |
DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDESWert: 19 Unterstützt ab Windows 10 Version 1703. Gibt eine Anforderung für Colorimetrieü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 Außerkraftsetzungen für den an das Ziel angefügten Monitor schreibt. 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 null lassen. Wenn der Treiber Überschreibungen aufweist, füllt er alle Felder des DXGK_COLORIMETRY aus, um die Überwachungsfunktionen zu beschreiben, da das Betriebssystem keine Teilüberschreibungen akzeptiert. |
DXGKQAITYPE_DISPLAYID_DESCRIPTORWert: 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_FRAMEBUFFERSAVESIZEWert: 21 Der KMD sollte eine DXGK_FRAMEBUFFERSAVEAREA-Struktur mit der Größe des Framepuffers auffüllen, der während der Energieübergänge im Systemspeicher gespeichert werden soll. Unterstützt ab Windows 10 Version 1803. |
DXGKQAITYPE_HARDWARERESERVEDRANGESWert: 22 Die KMD sollte eine DXGK_HARDWARERESERVEDRANGES-Struktur mit ihren reservierten Hardwarespeicherbereichen auffüllen. Unterstützt ab Windows 10 Version 1803. |
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2Wert: 23 Unterstützt ab Windows 10 Version 1803. 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. Untergeordnete TypeIntegratedDisplay-Geräte werden durch Aufrufen von DxgkDdiQueryAdapterInfo gemeldet, wobei der Typ auf diesen Wert festgelegt ist. |
DXGKQAITYPE_NODEPERFDATAWert: 24 Der KMD sollte eine DXGK_NODE_PERFDATA-Struktur auffüllen, die leistungsbasierte Daten darstellt, die pro Engine von einem Adapter auf Intervallbasis gesammelt werden. Unterstützt ab Windows 10 Version 1803. |
DXGKQAITYPE_ADAPTERPERFDATAWert: 25 Der KMD sollte eine DXGK_ADAPTER_PERFDATA-Struktur auffüllen, die die pro Adapter gesammelten Leistungsdaten auf Intervallbasis darstellt. Unterstützt ab Windows 10 Version 1803. |
DXGKQAITYPE_ADAPTERPERFDATA_CAPSWert: 26 Die KMD sollte eine DXGK_ADAPTER_PERFDATACAPS Struktur auffüllen, die statische Datenfunktionen darstellt und während der Initialisierung einmal pro GPU abgefragt wird. Unterstützt ab Windows 10 Version 1803. |
DXGKQAITYPE_GPUVERSIONWert: 27 Die KMD sollte eine DXGK_GPUVERSION Struktur auffüllen , die zum Erfassen der BIOS-Version und des GPU-Architekturnamens während der GPU-Initialisierung verwendet wird. Unterstützt ab Windows 10 Version 1803. |
DXGKQAITYPE_DEVICE_TYPE_CAPSWert: 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_WDDMDEVICECAPSWert: 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_GPUPCAPSWert: 30 Der 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_QUERYTARGETGAMMACAPSWert: 31 Der KMD sollte eine DXGK_TARGET_GAMMA_CAPS Struktur auffüllen, die die Gammafunktionen des KMD beschreibt. Unterstützt ab Windows 10 Version 1903. |
DXGKQAITYPE_SCANOUT_CAPSWert: 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_CAPSWert: 34 Die KMD sollte eine DXGK_PHYSICAL_MEMORY_CAPS Struktur auffüllen, die die Einschränkungen des physischen Speichers (die höchste sichtbare physische Adresse) des Geräts beschreibt. Unterstützt ab Windows Server 2022 (WDDM 2.9). Weitere Informationen zum Angeben der Treiberunterstützung für die lineare IOMMU-Neuzuordnung finden Sie unter DXGKQAITYPE_IOMMU_CAPS . |
DXGKQAITYPE_IOMMU_CAPSWert: 35 Die KMD sollte eine DXGK_IOMMU_CAPS-Struktur auffüllen, die angibt, dass die lineare IOMMU-Neuzuordnung vom Treiber unterstützt wird. Unterstützt ab Windows Server 2022 (WDDM 2.9). 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 kein vorhandener physischer Arbeitsspeicher vom Gerät referenziert wird. Daher lautet die Aufrufsequenz von Dxgkrnl 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 das Gerät erstellt und an eine IOMMU-Domäne angefügt werden kann, bevor auf den Arbeitsspeicher zugegriffen werden kann. * Rufen Sie DxgkDdiStartDevice auf, um das Gerät zu starten. |
DXGKQAITYPE_HARDWARERESERVEDRANGES2Wert: 36 |
DXGKQAITYPE_NATIVE_FENCE_CAPSWert: 37 Die KMD sollte eine DXGK_NATIVE_FENCE_CAPS-Struktur auffüllen, die die Supportdetails des Treibers für native GPU-Zäune enthält. Unterstützt ab Windows 11 Version 24H2. Weitere Informationen finden Sie unter Native GPU-Zäune. |
DXGKQAITYPE_USERMODESUBMISSION_CAPSWert: 38 Die KMD sollte eine DXGK_USERMODESUBMISSION_CAPS-Struktur auffüllen, die die Supportdetails des Treibers für die Arbeitsübermittlung im Benutzermodus enthält. Unterstützt ab Windows 11 Version 24H2. Weitere Informationen finden Sie unter Benutzermodus-Arbeitsübermittlung. |
DXGKQAITYPE_DIRTYBITTRACKINGCAPSWert: 39 Der KMD sollte eine DXGK_DIRTY_BIT_TRACKING_CAPS-Struktur auffüllen, die die Supportdetails des Treibers für modifiziert Bitnachverfolgung enthält. Unterstützt ab Windows 11 Version 24H2. Weitere Informationen finden Sie unter Dirty Bit Tracking. |
DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPSWert: 40 Die KMD sollte eine DXGK_DIRTY_BIT_TRACKING_SEGMENT_CAPS-Struktur auffüllen, die die Supportdetails des Treibers für modifiziert Bitnachverfolgung für ein bestimmtes Speichersegment enthält. Unterstützt ab Windows 11 Version 24H2. Weitere Informationen finden Sie unter Dirty Bit Tracking. |
DXGKQAITYPE_SCATTER_RESERVEWert: 41 Die KMD sollte eine DXGK_QUERYSCATTERRESERVEOUT-Struktur auffüllen, die die Supportdetails des Treibers für die Punktreserve enthält. Unterstützt ab Windows 11 Version 24H2. Weitere Informationen finden Sie unter Livemigration auf GPU-P-Geräten. |
Hinweise
Dxgkrnl ruft den DxgkDdiQueryAdapterInfo-Rückruf des KMD auf, um Konfigurationsinformationen von der Grafikkarte abzurufen. Der Treiber füllt die angeforderten Informationen im Puffer aus, auf den der pOutputData-Member der DXGKARG_QUERYADAPTERINFO-Struktur verweist. Sehen Sie sich die einzelnen Enumerationswerte für den Typ der auszufüllenden Struktur an.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Kopfzeile | d3dkmddi.h (einschließlich D3dkmddi.h) |
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für