enumerazione DXGK_QUERYADAPTERINFOTYPE (d3dkmddi.h)

Articolo
05/23/2024

L'enumerazione DXGK_QUERYADAPTERINFOTYPE indica il tipo di informazioni a cui deve essere restituito il driver miniport in modalità kernel nel buffer a cui pOutputData punta quando viene chiamata la funzione DxgkDdiQueryAdapterInfo. Per informazioni dettagliate sui tipi che richiedono l'input (pInputData), vedere DXGKARG_QUERYADAPTERINFO.

Sintassi

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;

Costanti


`DXGKQAITYPE_UMDRIVERPRIVATE` Valore: 0 Indica una struttura di dati privata e proprietaria per il driver di visualizzazione.
`DXGKQAITYPE_DRIVERCAPS` Valore: 1 Il KMD deve popolare una struttura DXGK_DRIVERCAPS con le funzionalità del driver.
`DXGKQAITYPE_QUERYSEGMENT` Valore: 2 Il KMD deve popolare una struttura DXGK_QUERYSEGMENTOUT con le informazioni sul segmento di memoria.
`DXGKQAITYPE_RESERVED` Valore: 3 Riservato per l'utilizzo nel sistema. Non usare nel driver. Questa costante si verifica a partire da Windows 7.
`DXGKQAITYPE_QUERYSEGMENT2` Valore: 4 Riservato per l'utilizzo nel sistema. Non usare nel driver. Questa costante si verifica a partire da Windows 7.
`DXGKQAITYPE_QUERYSEGMENT3` Valore: 5 Il KMD deve popolare una struttura DXGK_QUERYSEGMENTOUT3 con informazioni sul segmento di memoria. Supportato a partire da Windows 8.
`DXGKQAITYPE_NUMPOWERCOMPONENTS` Valore: 6 Il miniport di visualizzazione deve fornire un valore UINT che specifica il numero di componenti di alimentazione utilizzati. Supportato a partire da Windows 8.
`DXGKQAITYPE_POWERCOMPONENTINFO` Valore: 7 Il KMD deve popolare una struttura DXGK_POWER_RUNTIME_COMPONENT con informazioni sul ncomponente di alimentazione, dove n è l'indice componente specificato da DXGKARG_QUERYADAPTERINFO.pInputData in una chiamata a DxgkDdiQueryAdapterInfo. Supportato a partire da Windows 8.
`DXGKQAITYPE_PREFERREDGPUNODE` Valore: 8 Riservato per l'utilizzo nel sistema. Non usare nel driver. Questa costante si verifica a partire da Windows 8.
`DXGKQAITYPE_POWERCOMPONENTPSTATEINFO` Valore: 9 Riservato per l'utilizzo nel sistema. Non usare nel driver. Supportato a partire da Windows 8.1.
`DXGKQAITYPE_HISTORYBUFFERPRECISION` Valore: 10 Il KMD deve popolare una struttura DXGKARG_HISTORYBUFFERPRECISION con informazioni sulla precisione dei dati del buffer di cronologia usati. Supportato a partire da Windows 8.1.
`DXGKQAITYPE_QUERYSEGMENT4` Valore: 11 Il KMD deve popolare una struttura DXGK_QUERYSEGMENTOUT4 per indicare le informazioni sul segmento di memoria. Supportato a partire da Windows 10.
`DXGKQAITYPE_SEGMENTMEMORYSTATE` Valore: 12 Il KMD deve popolare una struttura DXGK_MEMORYRANGE con gli intervalli di memoria non validi. Supportato a partire da Windows 10.
`DXGKQAITYPE_GPUMMUCAPS` Valore: 13 Il KMD deve popolare una struttura DXGK_GPUMMUCAPS con le relative funzionalità di gestione della memoria virtuale. Supportato a partire da Windows 10.
`DXGKQAITYPE_PAGETABLELEVELDESC` Valore: 14 Riservato per l'utilizzo nel sistema. Non usare nel driver. Questa costante si verifica a partire da Windows 10.
`DXGKQAITYPE_PHYSICALADAPTERCAPS` Valore: 15 Riservato per l'utilizzo nel sistema. Non usare nel driver. Questa costante si verifica a partire da Windows 10.
`DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION` Valore: 16 Riservato per l'utilizzo nel sistema. Non usare nel driver. Questa costante si verifica a partire da Windows 10.
`DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR` Valore: 17 Supportato a partire da Windows 10 versione 1703. Indica una richiesta per un descrittore di pannello integrato in cui il buffer di input per la query sarà una struttura DXGK_QUERYINTEGRATEDDISPLAYIN e il buffer di output è una struttura DXGK_QUERYINTEGRATEDDISPLAYOUT . Anche se questa funzione punta a una destinazione, vengono acquisiti solo i blocchi dell'adattatore DxgKrnl tramite questa chiamata, non i blocchi del dispositivo figlio. In pratica, poiché questa chiamata verrà effettuata prima che il dispositivo figlio venga esposto, non dovrebbero esserci chiamate DDI simultanee che puntano alla stessa destinazione. NOTA: a differenza della maggior parte delle chiamate di QueryAdapterInfo, la dimensione del buffer di output è variabile anche se è ancora nota in anticipo dal campo DescriptorLength della struttura DXGK_INTEGRATED_DISPLAY_CHILD per l'ID di destinazione. Le dimensioni del buffer di output sono le seguenti: `DescriptorLength + FIELD_OFFSET( DXGK_QUERYINTEGRATEDDISPLAYOUT, Descriptor )`.
`DXGKQAITYPE_UEFIFRAMEBUFFERRANGES` Valore: 18 Indica la richiesta per gli intervalli di buffer dei frame UEFI. Supportato a partire da Windows 10 versione 1703.
`DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES` Valore: 19 Supportato a partire da Windows 10 versione 1703. Indica una richiesta di override dei colorimetry per una visualizzazione esterna, in cui il buffer di input per la query sarà una struttura DXGK_QUERYCOLORIMETRYOVERRIDESIN , contenente solo l'ID di destinazione a cui viene indirizzato e il buffer di output è una struttura DXGK_COLORIMETRY in cui il driver scrive gli override per il monitoraggio collegato alla destinazione. Anche se questa funzione punta a una destinazione, vengono acquisiti solo i blocchi dell'adattatore DxgKrnl tramite questa chiamata, non i blocchi del dispositivo figlio. Poiché questa chiamata verrà eseguita prima che il dispositivo figlio venga esposto, non devono essere presenti chiamate DDI simultanee che puntano alla stessa destinazione. Il buffer di output viene azzerato quando viene passato al driver. Se il driver non ha override per il monitoraggio, deve restituire STATUS_SUCCESS e lasciare zero il buffer di output. Se il driver ha override, compila tutti i campi del DXGK_COLORIMETRY per descrivere le funzionalità di monitoraggio perché il sistema operativo non accetterà sostituzioni parziali.
`DXGKQAITYPE_DISPLAYID_DESCRIPTOR` Valore: 20 Indica una richiesta per un descrittore del pannello integrato in cui il buffer di input per la query sarà una struttura DXGK_QAITARGETIN e il buffer di output è una struttura DXGK_QUERYINTEGRATEDDISPLAYOUT . Supportato a partire da Windows 10 versione 1709.
`DXGKQAITYPE_FRAMEBUFFERSAVESIZE` Valore: 21 Il KMD deve popolare una struttura DXGK_FRAMEBUFFERSAVEAREA con le dimensioni del buffer dei frame per salvare nella memoria di sistema durante le transizioni di alimentazione. Supportato a partire da Windows 10 versione 1803.
`DXGKQAITYPE_HARDWARERESERVEDRANGES` Valore: 22 Il KMD deve popolare una struttura di DXGK_HARDWARERESERVEDRANGES con i relativi intervalli di memoria riservata hardware. Supportato a partire da Windows 10 versione 1803.
`DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2` Valore: 23 Supportato a partire da Windows 10 versione 1803. Indica una richiesta per un descrittore di pannello integrato in cui il buffer di input per la query sarà una struttura DXGK_QAITARGETIN e il buffer di output è una struttura DXGK_QUERYINTEGRATEDDISPLAYOUT2 . Questa query sostituisce l'uso della query DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR per i driver WDDM 2.4. I dispositivi figlio TypeIntegratedDisplay vengono segnalati chiamando DxgkDdiQueryAdapterInfo con il tipo impostato su questo valore.
`DXGKQAITYPE_NODEPERFDATA` Valore: 24 Il KMD deve popolare una struttura DXGK_NODE_PERFDATA che rappresenta i dati sulle prestazioni raccolti per ogni motore da un adattatore a intervalli. Supportato a partire da Windows 10 versione 1803.
`DXGKQAITYPE_ADAPTERPERFDATA` Valore: 25 Il KMD deve popolare una struttura di DXGK_ADAPTER_PERFDATA che rappresenta i dati sulle prestazioni raccolti per ogni adattatore a intervalli. Supportato a partire da Windows 10 versione 1803.
`DXGKQAITYPE_ADAPTERPERFDATA_CAPS` Valore: 26 Il kmD deve popolare una struttura di DXGK_ADAPTER_PERFDATACAPS che rappresenta le funzionalità dei dati statiche ed eseguite query una sola volta per GPU durante l'inizializzazione. Supportato a partire da Windows 10 versione 1803.
`DXGKQAITYPE_GPUVERSION` Valore: 27 Il KMD deve popolare una struttura DXGK_GPUVERSION utilizzata per raccogliere la versione DEL BIOS e il nome dell'architettura GPU una volta durante l'inizializzazione della GPU. Supportato a partire da Windows 10 versione 1803.
`DXGKQAITYPE_DEVICE_TYPE_CAPS` Valore: 28 Il KMD deve popolare una struttura DXGK_DEVICE_TYPE_CAPS che descrive il tipo di funzionalità per un dispositivo. Supportato a partire da Windows 10, versione 1809.
`DXGKQAITYPE_WDDMDEVICECAPS` Valore: 29 Il servizio di gestione delle chiavi deve popolare una struttura DXGK_WDDMDEVICECAPS contenente le funzionalità WDDM eseguite dal sistema operativo durante l'inizializzazione del dispositivo. Supportato a partire da Windows 10 versione 1903.
`DXGKQAITYPE_GPUPCAPS` Valore: 30 Il KMD deve popolare una struttura DXGK_GPUPCAPS che contiene le funzionalità GPU per un driver di visualizzazione in modalità kernel. Supportato a partire da Windows 10 versione 1903.
`DXGKQAITYPE_QUERYTARGETGAMMACAPS` Valore: 31 Il KMD deve popolare una struttura DXGK_TARGET_GAMMA_CAPS che descrive le funzionalità gamma del KMD. Supportato a partire da Windows 10 versione 1903.
`DXGKQAITYPE_SCANOUT_CAPS` Valore: 33 Il kmD deve popolare una struttura DXGK_QUERY_SCANOUT_CAPS_OUT che descrive le funzionalità di analisi del driver. Supportato a partire da Windows 10 versione 1903.
`DXGKQAITYPE_PHYSICAL_MEMORY_CAPS` Valore: 34 Il KMD deve popolare una struttura DXGK_PHYSICAL_MEMORY_CAPS che descrive le restrizioni di memoria fisica (l'indirizzo fisico più alto visibile) del dispositivo. Supportato a partire da Windows Server 2022 (WDDM 2.9). Vedere DXGKQAITYPE_IOMMU_CAPS per informazioni dettagliate su come indicare il supporto del driver per il remapping lineare IOMMU.
`DXGKQAITYPE_IOMMU_CAPS` Valore: 35 Il KMD deve popolare una struttura DXGK_IOMMU_CAPS che indica che il remapping lineare di IOMMU è supportato dal driver. Supportato a partire da Windows Server 2022 (WDDM 2.9). Per indicare il supporto per il remapping lineare, il driver deve anche informare Dxgkernel sulle restrizioni di memoria fisica tramite il limite di DXGKQAITYPE_PHYSICAL_MEMORY_CAPS . Il remapping logico può essere eseguito solo se non viene fatto riferimento a memoria fisica esistente dal dispositivo, quindi la sequenza di chiamate di Dxgkrnl è la seguente: * Chiamare DxgkDdiAddDevice per tutte le schede fisiche, in modo che il driver possa raccogliere informazioni per tutte le schede fisiche collegate. * Chiamare DxgkDdiQueryAdapterInfo con DXGKQAITYPE_PHYSICAL_MEMORY_CAPS e DXGKQAITYPE_IOMMU_CAPS in modo che possa quindi creare e collegare il dispositivo a un dominio IOMMU prima di poter accedere a qualsiasi memoria. * Chiamare DxgkDdiStartDevice per avviare il dispositivo.
`DXGKQAITYPE_HARDWARERESERVEDRANGES2` Valore: 36
`DXGKQAITYPE_NATIVE_FENCE_CAPS` Valore: 37 Il KMD deve popolare una struttura DXGK_NATIVE_FENCE_CAPS che contiene i dettagli del supporto del driver per le barriere GPU native. Supportato a partire da Windows 11 versione 24H2. Per altre informazioni, vedere Barriere GPU native.
`DXGKQAITYPE_USERMODESUBMISSION_CAPS` Valore: 38 Il KMD deve popolare una struttura DXGK_USERMODESUBMISSION_CAPS contenente i dettagli del supporto del driver per l'invio in modalità utente. Supportato a partire da Windows 11 versione 24H2. Per altre informazioni, vedere Invio in modalità utente.
`DXGKQAITYPE_DIRTYBITTRACKINGCAPS` Valore: 39 Il KMD deve popolare una struttura DXGK_DIRTY_BIT_TRACKING_CAPS contenente i dettagli del supporto del driver per il rilevamento dei bit sporchi. Supportato a partire da Windows 11 versione 24H2. Per altre informazioni, vedere Rilevamento bit sporco.
`DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPS` Valore: 40 Il kmD deve popolare una struttura DXGK_DIRTY_BIT_TRACKING_SEGMENT_CAPS che contiene i dettagli di supporto del driver per il rilevamento dei bit sporchi in un segmento di memoria specifico. Supportato a partire da Windows 11 versione 24H2. Per altre informazioni, vedere Rilevamento bit sporco.
`DXGKQAITYPE_SCATTER_RESERVE` Valore: 41 Il kmD deve popolare una struttura DXGK_QUERYSCATTERRESERVEOUT che contiene i dettagli di supporto del driver per la riserva a dispersione. Supportato a partire da Windows 11 versione 24H2. Per altre informazioni, vedere Migrazione in tempo reale nei dispositivi GPU-P.

Commenti

Dxgkrnl chiama il callback dxgkDdiQueryAdapterInfo di DxgkDdiQueryAdapterInfo per recuperare le informazioni di configurazione dalla scheda grafica. Il driver riempie le informazioni richieste nel buffer a cui fa riferimento il membro pOutputData della struttura DXGKARG_QUERYADAPTERINFO . Vedere ogni valore di enumerazione per il tipo di struttura da compilare.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Intestazione	d3dkmddi.h (include D3dkmddi.h)

Vedi anche

DXGKARG_QUERYADAPTERINFO

DxgkDdiQueryAdapterInfo

Condividi tramite