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 (KMD) nel buffer che pOutputData punta quando viene chiamata la funzione DxgkDdiQueryAdapterInfo. Vedere DXGKARG_QUERYADAPTERINFO per informazioni dettagliate sui tipi che richiedono l'input (pInputData).
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 = 42,
DXGKQAITYPE_QUERYSEGMENTCOUNT = 43,
DXGKQAITYPE_QUERYSEGMENT5 = 44,
DXGKQAITYPE_QUERYMMUCOUNT = 45,
DXGKQAITYPE_QUERYMMUS = 46,
DXGKQAITYPE_64BITONLYCAPS = 47,
DXGKQAITYPE_PAGINGPROCESSGPUVASIZE = 48
} DXGK_QUERYADAPTERINFOTYPE;
Costanti
DXGKQAITYPE_UMDRIVERPRIVATEValore: 0 Indica una struttura di dati privata e proprietaria per il driver di visualizzazione. |
DXGKQAITYPE_DRIVERCAPSValore: 1 Il KmD deve popolare una struttura DXGK_DRIVERCAPS con le relative funzionalità del driver. |
DXGKQAITYPE_QUERYSEGMENTValore: 2 Il KMD deve popolare una struttura DXGK_QUERYSEGMENTOUT con le informazioni sul segmento di memoria. |
DXGKQAITYPE_RESERVEDValore: 3 Riservato per l'uso del sistema. Non usare nel driver. Questa costante si verifica a partire da Windows 7. |
DXGKQAITYPE_QUERYSEGMENT2Valore: 4 Riservato per l'uso del sistema. Non usare nel driver. Questa costante si verifica a partire da Windows 7. |
DXGKQAITYPE_QUERYSEGMENT3Valore: 5 Il kmD deve popolare una struttura DXGK_QUERYSEGMENTOUT3 con informazioni sul segmento di memoria. Supportato a partire da Windows 8. |
DXGKQAITYPE_NUMPOWERCOMPONENTSValore: 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_POWERCOMPONENTINFOValore: 7 Il kmD deve popolare una struttura di DXGK_POWER_RUNTIME_COMPONENT con informazioni sul componente di alimentazione n, dove n è l'indice componente specificato da DXGKARG_QUERYADAPTERINFO.pInputData in una chiamata a DxgkDdiQueryAdapterInfo. Supportato a partire da Windows 8. |
DXGKQAITYPE_PREFERREDGPUNODEValore: 8 Riservato per l'uso del sistema. Non usare nel driver. Questa costante si verifica a partire da Windows 8. |
DXGKQAITYPE_POWERCOMPONENTPSTATEINFOValore: 9 Riservato per l'uso del sistema. Non usare nel driver. Supportato a partire da Windows 8.1. |
DXGKQAITYPE_HISTORYBUFFERPRECISIONValore: 10 Il kmD 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_QUERYSEGMENT4Valore: 11 Il KMD deve popolare una struttura DXGK_QUERYSEGMENTOUT4 per indicare le informazioni sul segmento di memoria. Supportato a partire da Windows 10. |
DXGKQAITYPE_SEGMENTMEMORYSTATEValore: 12 Il KmD deve popolare una struttura DXGK_MEMORYRANGE con gli intervalli di memoria non valido. Supportato a partire da Windows 10. |
DXGKQAITYPE_GPUMMUCAPSValore: 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_PAGETABLELEVELDESCValore: 14 Riservato per l'uso del sistema. Non usare nel driver. Questa costante si verifica a partire da Windows 10. |
DXGKQAITYPE_PHYSICALADAPTERCAPSValore: 15 Riservato per l'uso del sistema. Non usare nel driver. Questa costante si verifica a partire da Windows 10. |
DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSIONValore: 16 Riservato per l'uso del sistema. Non usare nel driver. Questa costante si verifica a partire da Windows 10. |
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTORValore: 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 della scheda DxgKrnl durante questa chiamata, non i blocchi dei dispositivi 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 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_UEFIFRAMEBUFFERRANGESValore: 18 Indica la richiesta per gli intervalli di buffer dei frame UEFI. Supportato a partire da Windows 10 versione 1703. |
DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDESValore: 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 per la query sarà una struttura DXGK_QUERYCOLORIMETRYOVERRIDESIN, contenente solo l'ID di destinazione 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 della scheda DxgKrnl durante questa chiamata, non i blocchi dei dispositivi figlio. Poiché questa chiamata verrà effettuata 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 il buffer di output azzerato. 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_DESCRIPTORValore: 20 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_QUERYINTEGRATEDDISPLAYOUT. Supportato a partire da Windows 10 versione 1709. |
DXGKQAITYPE_FRAMEBUFFERSAVESIZEValore: 21 Il kmD deve popolare una struttura DXGK_FRAMEBUFFERSAVEAREA con le dimensioni del buffer dei frame per risparmiare nella memoria di sistema durante le transizioni di alimentazione. Supportato a partire da Windows 10 versione 1803. |
DXGKQAITYPE_HARDWARERESERVEDRANGESValore: 22 Il KMD deve popolare una struttura DXGK_HARDWARERESERVEDRANGES con gli intervalli di memoria riservati hardware. Supportato a partire da Windows 10 versione 1803. |
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2Valore: 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. typeIntegratedDisplay dispositivi figlio vengono segnalati chiamando DxgkDdiQueryAdapterInfo con tipo impostato su questo valore. |
DXGKQAITYPE_NODEPERFDATAValore: 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_ADAPTERPERFDATAValore: 25 Il kmD 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_CAPSValore: 26 Il KMD deve popolare una struttura DXGK_ADAPTER_PERFDATACAPS che rappresenta le funzionalità dei dati statiche e sottoposte a query una sola volta per GPU durante l'inizializzazione. Supportato a partire da Windows 10 versione 1803. |
DXGKQAITYPE_GPUVERSIONValore: 27 Il KMD 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_CAPSValore: 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_WDDMDEVICECAPSValore: 29 Il KMD 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_GPUPCAPSValore: 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_QUERYTARGETGAMMACAPSValore: 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_CAPSValore: 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_CAPSValore: 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). Per informazioni dettagliate su come indicare il supporto dei driver per il mapping lineare di IOMMU, vedere DXGKQAITYPE_IOMMU_CAPS. |
DXGKQAITYPE_IOMMU_CAPSValore: 35 Il KMD 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 remapping logico può essere eseguito solo se non viene fatto riferimento a memoria fisica esistente dal dispositivo, quindi dxgkrnlsequenza di chiamata è 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. * Chiama DxgkDdiStartDevice per avviare il dispositivo. |
DXGKQAITYPE_HARDWARERESERVEDRANGES2Valore: 36 |
DXGKQAITYPE_NATIVE_FENCE_CAPSValore: 37 Il KMD deve popolare una struttura di DXGK_NATIVE_FENCE_CAPS che contiene i dettagli di supporto del driver per i recinti GPU nativi. Supportato a partire da Windows 11 versione 24H2. Per altre informazioni, vedere recinto GPU nativa. |
DXGKQAITYPE_USERMODESUBMISSION_CAPSValore: 38 Il KMD deve popolare una struttura DXGK_USERMODESUBMISSION_CAPS che contiene i dettagli di supporto del driver per l'invio di lavoro in modalità utente. Supportato a partire da Windows 11 versione 24H2. Per altre informazioni, vedere invio di lavoro in modalità utente. |
DXGKQAITYPE_DIRTYBITTRACKINGCAPSValore: 39 Il KMD deve popolare una struttura DXGK_DIRTY_BIT_TRACKING_CAPS che contiene i dettagli di supporto del driver per il rilevamento dei bit dirty. Supportato a partire da Windows 11 versione 24H2. Per altre informazioni, vedere Rilevamento bit dirty. |
DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPSValore: 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 dirty in un segmento di memoria specifico. Supportato a partire da Windows 11 versione 24H2. Per altre informazioni, vedere Rilevamento bit dirty. |
DXGKQAITYPE_SCATTER_RESERVEValore: 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. |
DXGKQAITYPE_QUERYPAGINGBUFFERINFOValore: 42 |
DXGKQAITYPE_QUERYSEGMENTCOUNTValore: 43 |
DXGKQAITYPE_QUERYSEGMENT5Valore: 44 |
DXGKQAITYPE_QUERYMMUCOUNTValore: 45 |
DXGKQAITYPE_QUERYMMUSValore: 46 |
DXGKQAITYPE_64BITONLYCAPSValore: 47 |
DXGKQAITYPE_PAGINGPROCESSGPUVASIZEValore: 48 Il kmD deve restituire le dimensioni dello spazio VA della GPU del processo di paging, in megabyte. Per altre informazioni, vedere notifica di allocazione. Disponibile a partire da Windows 11 versione 24H2 (WDDM 3.2). |
Osservazioni
Dxgkrnl chiama il callback DxgkDdiQueryAdapterInfo del KMD per recuperare informazioni di configurazione dalla scheda grafica. Il driver riempie le informazioni richieste nel buffer a cui punta il pOutputData membro della struttura DXGKARG_QUERYADAPTERINFO. Vedere ogni valore di enumerazione per il tipo di struttura da compilare.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| intestazione | d3dkmddi.h (include D3dkmddi.h) |