énumération DXGK_QUERYADAPTERINFOTYPE (d3dkmddi.h)

L’énumération DXGK_QUERYADAPTERINFOTYPE indique le type d’informations vers laquelle le pilote kmD (kernel-mode display miniport driver) doit retourner dans la mémoire tampon vers laquelle pOutputData pointe quand sa fonction DxgkDdiQueryAdapterInfo est appelée. Consultez DXGKARG_QUERYADAPTERINFO pour plus d’informations sur les types qui nécessitent une entrée (pInputData).

Syntaxe

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;

Constantes

DXGKQAITYPE_UMDRIVERPRIVATE Valeur : 0 Indique une structure de données privée définie par propriétaire pour le pilote d’affichage.
DXGKQAITYPE_DRIVERCAPS Valeur : 1 Le kmD doit remplir une structure DXGK_DRIVERCAPS avec ses fonctionnalités de pilote.
DXGKQAITYPE_QUERYSEGMENT Valeur : 2 Le KMD doit remplir une structure DXGK_QUERYSEGMENTOUT avec ses informations de segment de mémoire.
DXGKQAITYPE_RESERVED Valeur : 3 Réservé à l’utilisation du système. N’utilisez pas votre pilote. Cette constante se produit à partir de Windows 7.
DXGKQAITYPE_QUERYSEGMENT2 Valeur : 4 Réservé à l’utilisation du système. N’utilisez pas votre pilote. Cette constante se produit à partir de Windows 7.
DXGKQAITYPE_QUERYSEGMENT3 Valeur : 5 Le kmD doit remplir une structure DXGK_QUERYSEGMENTOUT3 avec des informations de segment de mémoire. Prise en charge à partir de Windows 8.
DXGKQAITYPE_NUMPOWERCOMPONENTS Valeur : 6 La miniport d’affichage doit fournir une valeur UINT qui spécifie le nombre de composants d’alimentation qu’il utilise. Prise en charge à partir de Windows 8.
DXGKQAITYPE_POWERCOMPONENTINFO Valeur : 7 Le KMD doit remplir une structure DXGK_POWER_RUNTIME_COMPONENT avec des informations sur le composant nth power, où n est l’index de composant spécifié par DXGKARG_QUERYADAPTERINFO.pInputData dans un appel à DxgkDdiQueryAdapterInfo. Prise en charge à partir de Windows 8.
DXGKQAITYPE_PREFERREDGPUNODE Valeur : 8 Réservé à l’utilisation du système. N’utilisez pas votre pilote. Cette constante se produit à partir de Windows 8.
DXGKQAITYPE_POWERCOMPONENTPSTATEINFO Valeur : 9 Réservé à l’utilisation du système. N’utilisez pas votre pilote. Prise en charge à partir de Windows 8.1.
DXGKQAITYPE_HISTORYBUFFERPRECISION Valeur : 10 Le kmD doit remplir une structure DXGKARG_HISTORYBUFFERPRECISION avec des informations sur la précision des données de mémoire tampon de l’historique qu’elle utilise. Prise en charge à partir de Windows 8.1.
DXGKQAITYPE_QUERYSEGMENT4 Valeur : 11 Le KMD doit remplir une structure DXGK_QUERYSEGMENTOUT4 pour indiquer ses informations de segment de mémoire. Prise en charge à partir de Windows 10.
DXGKQAITYPE_SEGMENTMEMORYSTATE Valeur : 12 Le KMD doit remplir une structure DXGK_MEMORYRANGE avec ses plages de mémoire incorrectes. Prise en charge à partir de Windows 10.
DXGKQAITYPE_GPUMMUCAPS Valeur : 13 Le KMD doit remplir une structure DXGK_GPUMMUCAPS avec ses fonctionnalités de gestion de la mémoire virtuelle. Prise en charge à partir de Windows 10.
DXGKQAITYPE_PAGETABLELEVELDESC Valeur : 14 Réservé à l’utilisation du système. N’utilisez pas votre pilote. Cette constante se produit à partir de Windows 10.
DXGKQAITYPE_PHYSICALADAPTERCAPS Valeur : 15 Réservé à l’utilisation du système. N’utilisez pas votre pilote. Cette constante se produit à partir de Windows 10.
DXGKQAITYPE_DISPLAY_DRIVERCAPS_EXTENSION Valeur : 16 Réservé à l’utilisation du système. N’utilisez pas votre pilote. Cette constante se produit à partir de Windows 10.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR Valeur : 17 Prise en charge à partir de Windows 10, version 1703. Indique une demande de descripteur de panneau intégré où la mémoire tampon d’entrée à la requête sera une structure DXGK_QUERYINTEGRATEDDISPLAYIN et la mémoire tampon de sortie est une structure DXGK_QUERYINTEGRATEDDISPLAYOUT. Bien que cette fonction traite une cible, seuls les verrous d’adaptateur DxgKrnl sont pris en charge par cet appel, et non sur les verrous d’appareil enfant. Dans la pratique, étant donné que cet appel sera effectué avant l’exposition de l’appareil enfant, il ne doit y avoir aucun appel DDI simultané qui adresse la même cible. REMARQUE : Contrairement à la plupart des appels QueryAdapterInfo, la taille de la mémoire tampon de sortie est variable, bien qu’elle soit toujours connue à l’avance à partir du champ DescriptorLength de la structure DXGK_INTEGRATED_DISPLAY_CHILD pour l’ID cible. La taille de la mémoire tampon de sortie est la suivante : DescriptorLength + FIELD_OFFSET( DXGK_QUERYINTEGRATEDDISPLAYOUT, Descriptor ).
DXGKQAITYPE_UEFIFRAMEBUFFERRANGES Valeur : 18 Indique la demande pour les plages de mémoires tampons d’images UEFI. Prise en charge à partir de Windows 10, version 1703.
DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES Valeur : 19 Prise en charge à partir de Windows 10, version 1703. Indique une demande de remplacements de colorimétrie pour un affichage externe, où la mémoire tampon d’entrée dans la requête sera une structure DXGK_QUERYCOLORIMETRYOVERRIDESIN, contenant uniquement l’ID cible en cours d’adresse et la mémoire tampon de sortie est une structure DXGK_COLORIMETRY dans laquelle le pilote écrit des remplacements pour le moniteur attaché à la cible. Bien que cette fonction traite une cible, seuls les verrous d’adaptateur DxgKrnl sont pris en charge par cet appel, et non sur les verrous d’appareil enfant. Étant donné que cet appel sera effectué avant l’exposition de l’appareil enfant, il ne doit y avoir aucun appel DDI simultané qui adresse la même cible. La mémoire tampon de sortie est annulée lorsqu’elle est passée au pilote. Si le pilote n’a pas de remplacement pour le moniteur, il doit retourner STATUS_SUCCESS et laisser la mémoire tampon de sortie mise à zéro. Si le pilote a des remplacements, il renseigne tous les champs de l’DXGK_COLORIMETRY pour décrire les fonctionnalités du moniteur, car le système d’exploitation n’accepte pas les remplacements partiels.
DXGKQAITYPE_DISPLAYID_DESCRIPTOR Valeur : 20 Indique une demande de descripteur de panneau intégré où la mémoire tampon d’entrée de la requête sera une structure DXGK_QAITARGETIN et la mémoire tampon de sortie est une structure DXGK_QUERYINTEGRATEDDISPLAYOUT. Prise en charge à partir de Windows 10, version 1709.
DXGKQAITYPE_FRAMEBUFFERSAVESIZE Valeur : 21 Le KMD doit remplir une structure DXGK_FRAMEBUFFERSAVEAREA avec la taille de la mémoire tampon d’images pour enregistrer la mémoire système pendant les transitions d’alimentation. Prise en charge à partir de Windows 10, version 1803.
DXGKQAITYPE_HARDWARERESERVEDRANGES Valeur : 22 Le KMD doit remplir une structure DXGK_HARDWARERESERVEDRANGES avec ses plages de mémoire réservées matérielles. Prise en charge à partir de Windows 10, version 1803.
DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR2 Valeur : 23 Prise en charge à partir de Windows 10, version 1803. Indique une demande de descripteur de panneau intégré où la mémoire tampon d’entrée de la requête sera une structure DXGK_QAITARGETIN et la mémoire tampon de sortie est une structure DXGK_QUERYINTEGRATEDDISPLAYOUT2. Cette requête remplace l’utilisation de la requête DXGKQAITYPE_INTEGRATED_DISPLAY_DESCRIPTOR pour les pilotes WDDM 2.4. TypeIntegratedDisplay appareils enfants sont signalés en appelant DxgkDdiQueryAdapterInfo avec le type défini sur cette valeur.
DXGKQAITYPE_NODEPERFDATA Valeur : 24 Le kmD doit remplir une structure DXGK_NODE_PERFDATA qui représente les données de performances collectées par moteur à partir d’un adaptateur à intervalles. Prise en charge à partir de Windows 10, version 1803.
DXGKQAITYPE_ADAPTERPERFDATA Valeur : 25 Le kmD doit remplir une structure DXGK_ADAPTER_PERFDATA qui représente les données de performances collectées par adaptateur à intervalles. Prise en charge à partir de Windows 10, version 1803.
DXGKQAITYPE_ADAPTERPERFDATA_CAPS Valeur : 26 Le KMD doit remplir une structure DXGK_ADAPTER_PERFDATACAPS qui représente les fonctionnalités de données statiques et interrogées une fois par GPU lors de l’initialisation. Prise en charge à partir de Windows 10, version 1803.
DXGKQAITYPE_GPUVERSION Valeur : 27 Le KMD doit remplir une structure DXGK_GPUVERSION utilisée pour collecter la version du BIOS et le nom de l’architecture GPU une fois lors de l’initialisation du GPU. Prise en charge à partir de Windows 10, version 1803.
DXGKQAITYPE_DEVICE_TYPE_CAPS Valeur : 28 Le kmD doit remplir une structure DXGK_DEVICE_TYPE_CAPS qui décrit le type de fonctionnalités d’un appareil. Prise en charge à partir de Windows 10, version 1809.
DXGKQAITYPE_WDDMDEVICECAPS Valeur : 29 Le kmD doit remplir une structure DXGK_WDDMDEVICECAPS qui contient les fonctionnalités WDDM interrogées par le système d’exploitation lors de l’initialisation de l’appareil. Prise en charge à partir de Windows 10, version 1903.
DXGKQAITYPE_GPUPCAPS Valeur : 30 Le kmD doit remplir une structure DXGK_GPUPCAPS qui contient les fonctionnalités GPU d’un pilote d’affichage en mode noyau. Prise en charge à partir de Windows 10, version 1903.
DXGKQAITYPE_QUERYTARGETGAMMACAPS Valeur : 31 Le KMD doit remplir une structure DXGK_TARGET_GAMMA_CAPS qui décrit les fonctionnalités gamma du KMD. Prise en charge à partir de Windows 10, version 1903.
DXGKQAITYPE_SCANOUT_CAPS Valeur : 33 Le kmD doit remplir une structure DXGK_QUERY_SCANOUT_CAPS_OUT qui décrit les fonctionnalités d’analyse du pilote. Prise en charge à partir de Windows 10, version 1903.
DXGKQAITYPE_PHYSICAL_MEMORY_CAPS Valeur : 34 Le KMD doit remplir une structure DXGK_PHYSICAL_MEMORY_CAPS qui décrit les restrictions de mémoire physique (adresse physique visible la plus élevée) de l’appareil. Prise en charge à partir de Windows Server 2022 (WDDM 2.9). Consultez DXGKQAITYPE_IOMMU_CAPS pour plus d’informations sur la façon d’indiquer la prise en charge des pilotes pour le remapping linéaire IOMMU.
DXGKQAITYPE_IOMMU_CAPS Valeur : 35 Le kmD doit remplir une structure DXGK_IOMMU_CAPS qui indique que le remappage linéaire IOMMU est pris en charge par le pilote. Prise en charge à partir de Windows Server 2022 (WDDM 2.9). Pour indiquer la prise en charge du remapping linéaire, le pilote doit également informer Dxgkernel sur ses restrictions de mémoire physique par le biais de la limite de DXGKQAITYPE_PHYSICAL_MEMORY_CAPS. Le remappage logique ne peut être effectué que si aucune mémoire physique existante n’est référencée par l’appareil. Par conséquent, séquence d’appels de Dxgkrnlest la suivante : * Appelez DxgkDdiAddDevice pour toutes les cartes physiques, afin que le pilote puisse collecter des informations pour toutes les cartes physiques liées. * Appelez DxgkDdiQueryAdapterInfo avec DXGKQAITYPE_PHYSICAL_MEMORY_CAPS et DXGKQAITYPE_IOMMU_CAPS afin qu’il puisse ensuite créer et attacher l’appareil à un domaine IOMMU avant tout accès à la mémoire. * Appelez DxgkDdiStartDevice pour démarrer l’appareil.
DXGKQAITYPE_HARDWARERESERVEDRANGES2 Valeur : 36
DXGKQAITYPE_NATIVE_FENCE_CAPS Valeur : 37 Le kmD doit remplir une structure DXGK_NATIVE_FENCE_CAPS qui contient les détails de prise en charge du pilote pour les clôtures GPU natives. Prise en charge à partir de Windows 11, version 24H2. Pour plus d’informations, consultez clôtures GPU natives.
DXGKQAITYPE_USERMODESUBMISSION_CAPS Valeur : 38 Le kmD doit remplir une structure DXGK_USERMODESUBMISSION_CAPS qui contient les détails de prise en charge du pilote pour la soumission de travail en mode utilisateur. Prise en charge à partir de Windows 11, version 24H2. Pour plus d’informations, consultez soumission de travail en mode utilisateur.
DXGKQAITYPE_DIRTYBITTRACKINGCAPS Valeur : 39 Le kmD doit remplir une structure DXGK_DIRTY_BIT_TRACKING_CAPS qui contient les détails de prise en charge du pilote pour le suivi des bits incorrects. Prise en charge à partir de Windows 11, version 24H2. Pour plus d’informations, consultez suivi des bits sales.
DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPS Valeur : 40 Le kmD doit remplir une structure DXGK_DIRTY_BIT_TRACKING_SEGMENT_CAPS qui contient les détails de prise en charge du pilote pour le suivi des bits incorrects sur un segment de mémoire spécifique. Prise en charge à partir de Windows 11, version 24H2. Pour plus d’informations, consultez suivi des bits sales.
DXGKQAITYPE_SCATTER_RESERVE Valeur : 41 Le kmD doit remplir une structure DXGK_QUERYSCATTERRESERVEOUT qui contient les détails de prise en charge du pilote pour la réserve de nuages de points. Prise en charge à partir de Windows 11, version 24H2. Pour plus d’informations, consultez migration dynamique sur les appareils GPU-P.
DXGKQAITYPE_QUERYPAGINGBUFFERINFO Valeur : 42
DXGKQAITYPE_QUERYSEGMENTCOUNT Valeur : 43
DXGKQAITYPE_QUERYSEGMENT5 Valeur : 44
DXGKQAITYPE_QUERYMMUCOUNT Valeur : 45
DXGKQAITYPE_QUERYMMUS Valeur : 46
DXGKQAITYPE_64BITONLYCAPS Valeur : 47
DXGKQAITYPE_PAGINGPROCESSGPUVASIZE Valeur : 48 KMD doit retourner la taille de l’espace GPU VA du processus de pagination, en mégaoctets. Pour plus d’informations, consultez notification d’allocation. Disponible à partir de Windows 11, version 24H2 (WDDM 3.2).

Remarques

Dxgkrnl appelle le rappel DxgkDdiQueryAdapterInfo KMD pour récupérer les informations de configuration de l’adaptateur graphique. Le pilote remplit les informations demandées dans la mémoire tampon pointée par le membre pOutputData de la structure DXGKARG_QUERYADAPTERINFO. Consultez chaque valeur d’énumération pour le type de structure à remplir.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
d’en-tête	d3dkmddi.h (include D3dkmddi.h)

Voir aussi

DXGKARG_QUERYADAPTERINFO

DxgkDdiQueryAdapterInfo