enumerazione DXGK_QUERYADAPTERINFOTYPE (d3dkmddi.h)

Articolo
03/08/2023

L'enumerazione DXGK_QUERYADAPTERINFOTYPE indica il tipo di informazioni da recuperare quando viene chiamata la funzione DxgkDdiQueryAdapterInfo di un driver di visualizzazione.

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,
  DXGKQAITYPE_NATIVE_FENCE_CAPS,
  DXGKQAITYPE_USERMODESUBMISSION_CAPS
} 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 driver miniport visualizzato deve popolare una struttura DXGK_DRIVERCAPS con le relative funzionalità driver.
`DXGKQAITYPE_QUERYSEGMENT` Valore: 2 Il driver miniport visualizzato deve popolare una struttura DXGK_QUERYSEGMENTOUT con le relative 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 driver miniport visualizzato 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 usati. Supportato a partire da Windows 8.
`DXGKQAITYPE_POWERCOMPONENTINFO` Valore: 7 Il driver miniport visualizzato deve popolare una struttura DXGK_POWER_RUNTIME_COMPONENT con informazioni sul componente di alimentazione n, dove n è l'indice del 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 driver miniport visualizzato deve popolare una struttura DXGKARG_HISTORYBUFFERPRECISION con informazioni sulla precisione dei dati del buffer della cronologia usati. Supportato a partire da Windows 8.1.
`DXGKQAITYPE_QUERYSEGMENT4` Valore: 11 Il driver miniport visualizzato 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 driver miniport visualizzato deve popolare una struttura DXGK_MEMORYRANGE con i relativi intervalli di memoria non valido. Supportato a partire da Windows 10.
`DXGKQAITYPE_GPUMMUCAPS` Valore: 13 Il driver miniport visualizzato 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 del pannello integrato in cui il buffer di input della query sarà una struttura DXGK_QUERYINTEGRATEDDISPLAYIN e il buffer di output è una struttura DXGK_QUERYINTEGRATEDDISPLAYOUT . Anche se questa funzione si rivolge a una destinazione, solo i blocchi dell'adattatore DxgKrnl vengono presi in questa chiamata, non i blocchi del dispositivo figlio. In pratica, poiché questa chiamata verrà eseguita prima dell'esposizione del dispositivo figlio, non dovrebbero essere presenti chiamate DDI simultanee che indirizzano la stessa destinazione. NOTA: a differenza della maggior parte delle chiamate 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: `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 colorimetria per una visualizzazione esterna, in cui il buffer di input della query sarà una struttura DXGK_QUERYCOLORIMETRYOVERRIDESIN , contenente solo l'ID di destinazione da affrontare e il buffer di output è una struttura DXGK_COLORIMETRY in cui il driver scrive override per il monitoraggio collegato alla destinazione. Anche se questa funzione si rivolge a una destinazione, solo i blocchi dell'adattatore DxgKrnl vengono presi in 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 indirizzano la stessa destinazione. Il buffer di output viene zero 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 accetta gli overridi parziali.
`DXGKQAITYPE_DISPLAYID_DESCRIPTOR` Valore: 20 Indica una richiesta per un descrittore del pannello integrato in cui il buffer di input della 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 driver miniport visualizzato deve popolare una struttura DXGK_FRAMEBUFFERSAVEAREA con le dimensioni del buffer frame per salvare la memoria di sistema durante le transizioni di alimentazione. Supportato a partire da Windows 10 versione 1803.
`DXGKQAITYPE_HARDWARERESERVEDRANGES` Valore: 22 Il driver miniport di visualizzazione deve popolare una struttura DXGK_HARDWARERESERVEDRANGES con i relativi intervalli di memoria riservati 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 del pannello integrato in cui il buffer di input della 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 driver miniport visualizzato deve popolare una struttura DXGK_NODE_PERFDATA che rappresenta i dati sulle prestazioni raccolti per motore da un adattatore a intervalli. Supportato a partire da Windows 10 versione 1803.
`DXGKQAITYPE_ADAPTERPERFDATA` Valore: 25 Il driver miniport visualizzato deve popolare una struttura 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 driver miniport di visualizzazione deve popolare una struttura DXGK_ADAPTER_PERFDATACAPS che rappresenta le funzionalità di dati statiche e sottoposte a query una volta per GPU durante l'inizializzazione. Supportato a partire da Windows 10 versione 1803.
`DXGKQAITYPE_GPUVERSION` Valore: 27 Il driver miniport di visualizzazione deve popolare una struttura DXGK_GPUVERSION usata per raccogliere la versione del BIOS e il nome dell'architettura GPU una sola volta durante l'inizializzazione della GPU. Supportato a partire da Windows 10 versione 1803.
`DXGKQAITYPE_DEVICE_TYPE_CAPS` Valore: 28 Il driver miniport di visualizzazione 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 driver miniport di visualizzazione deve popolare una struttura DXGK_WDDMDEVICECAPS che contiene le funzionalità WDDM sottoposte a query dal sistema operativo durante l'inizializzazione del dispositivo. Supportato a partire da Windows 10 versione 1903.
`DXGKQAITYPE_GPUPCAPS` Valore: 30 Il driver miniport di visualizzazione 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 driver miniport di visualizzazione deve popolare una struttura DXGK_TARGET_GAMMA_CAPS che descrive le funzionalità gamma del driver miniport di visualizzazione. Supportato a partire da Windows 10 versione 1903.
`DXGKQAITYPE_SCANOUT_CAPS` Valore: 33 Il driver miniport di visualizzazione 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 driver miniport di visualizzazione deve popolare una struttura DXGK_PHYSICAL_MEMORY_CAPS che descrive le restrizioni di memoria fisica (l'indirizzo fisico visibile più alto) del dispositivo. Supportato a partire da Windows Server 2022 (WDDM 2.9). Per informazioni dettagliate su come indicare il supporto dei driver per il mapping lineare di IOMMU, vedere DXGKQAITYPE_IOMMU_CAPS .
`DXGKQAITYPE_IOMMU_CAPS` Valore: 35 Il driver miniport di visualizzazione deve popolare una struttura DXGK_IOMMU_CAPS che indica che il mapping lineare di IOMMU è supportato dal driver. Supportato a partire da Windows Server 2022 (WDDM 2.9). Per indicare il supporto per il mapping lineare, il driver deve anche informare Dxgkernel sulle restrizioni di memoria fisica attraverso il limite di DXGKQAITYPE_PHYSICAL_MEMORY_CAPS . Il mapping logico può essere eseguito solo se non viene fatto riferimento alla memoria fisica esistente dal dispositivo, quindi la sequenza di chiamata di Dxgkrnl è la seguente: * Chiama DxgkDdiAddDevice per tutte le schede fisiche, in modo che il driver possa raccogliere informazioni per tutte le schede fisiche collegate. * Chiama 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. * Chiama DxgkDdiStartDevice per avviare il dispositivo.

Commenti

Dxgkrnl chiama il callback DxgkDdiQueryAdapterInfo del driver miniport di visualizzazione per recuperare le informazioni di configurazione dalla scheda grafica. Il driver inserisce le informazioni richieste nel buffer a cui punta 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

Share via