enumerazione DXGK_QUERYADAPTERINFOTYPE (d3dkmddi.h)

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