énumération DXGK_FEATURE_ID (d3dukmdt.h)

Article
05/23/2024

Une valeur d’énumération DXGK_FEATURE_ID identifie une fonctionnalité WDDM.

Syntax

typedef enum _DXGK_FEATURE_ID {
  DXGK_FEATURE_HWSCH,
  DXGK_FEATURE_HWFLIPQUEUE,
  DXGK_FEATURE_LDA_GPUPV,
  DXGK_FEATURE_KMD_SIGNAL_CPU_EVENT,
  DXGK_FEATURE_USER_MODE_SUBMISSION,
  DXGK_FEATURE_SHARE_BACKING_STORE_WITH_KMD,
  DXGK_FEATURE_SAMPLE,
  DXGK_FEATURE_PAGE_BASED_MEMORY_MANAGER,
  DXGK_FEATURE_KERNEL_MODE_TESTING,
  DXGK_FEATURE_64K_PT_DEMOTION_FIX,
  DXGK_FEATURE_GPUPV_PRESENT_HWQUEUE,
  DXGK_FEATURE_GPUVAIOMMU,
  DXGK_FEATURE_NATIVE_FENCE,
  DXGK_FEATURE_QUERYSTATISTICS_EXTENSIONS
} DXGK_FEATURE_ID;

Constantes


`DXGK_FEATURE_HWSCH` Fonctionnalité de planification GPU accélérée par le matériel. La catégorie de fonctionnalité est DXGK_FEATURE_CATEGORY_DRIVER.
`DXGK_FEATURE_HWFLIPQUEUE` Fonctionnalité de file d’attente de basculement matériel . La catégorie de fonctionnalité est DXGK_FEATURE_CATEGORY_DRIVER.
`DXGK_FEATURE_LDA_GPUPV` Adaptateur d’affichage lié dans la fonctionnalité de paravirtualisation GPU. La catégorie de fonctionnalité est DXGK_FEATURE_CATEGORY_DRIVER.
`DXGK_FEATURE_KMD_SIGNAL_CPU_EVENT` Signalisation d’un événement d’UC par fonctionnalité KMD . La catégorie de fonctionnalité est DXGK_FEATURE_CATEGORY_DRIVER.
`DXGK_FEATURE_USER_MODE_SUBMISSION` Fonctionnalité de soumission en mode utilisateur. La catégorie de fonctionnalité est DXGK_FEATURE_CATEGORY_DRIVER.
`DXGK_FEATURE_SHARE_BACKING_STORE_WITH_KMD` Permettant à l’UMD de partager le magasin de stockage avec la fonctionnalité KMD. La catégorie de fonctionnalité est DXGK_FEATURE_CATEGORY_DRIVER.
`DXGK_FEATURE_SAMPLE` Les pilotes peuvent utiliser cette valeur pour tester leurs implémentations.
`DXGK_FEATURE_PAGE_BASED_MEMORY_MANAGER` Fonctionnalité de gestion de la mémoire basée sur les pages. La catégorie de fonctionnalité est DXGK_FEATURE_CATEGORY_DRIVER.
`DXGK_FEATURE_KERNEL_MODE_TESTING` Fonctionnalité d’interface de test en mode noyau. La catégorie de fonctionnalité est DXGK_FEATURE_CATEGORY_DRIVER.
`DXGK_FEATURE_64K_PT_DEMOTION_FIX` La rétrogradation de table de 64 000 pages du système d’exploitation corrige la « fonctionnalité », ce qui indique que le système d’exploitation a activé le correctif pour la rétrogradation de table de pages 64 000. La rétrogradation d’une table de pages de 64 Ko se produit lorsqu’une plage VA GPU mappée par 64 Ko de pages doit être partiellement mappée par 4 Ko de pages. Dans ce cas, la table de pages avec des entrées de 64 Ko est convertie (rétrogradée) en table de pages avec des entrées de 4 Ko. Le bogue était que la poignée de protection et d’allocation du pilote n’a pas été conservée pendant la rétrogradation. La catégorie de fonctionnalité est DXGK_FEATURE_CATEGORY_DRIVER. Pour plus d'informations, consultez la section Notes.
`DXGK_FEATURE_GPUPV_PRESENT_HWQUEUE` Le système d’exploitation a le correctif du problème dans la paravirtualisation gpu et la planification matérielle activés. Si un objet de contexte DXGK avait plusieurs files d’attente matérielles et que D3DKMTPresent a été appelé avec une file d’attente matérielle qui n’était pas le premier dans la liste des files d’attente, la toute première file d’attente matérielle a été utilisée sur l’hôte pour gérer le présent. La catégorie de fonctionnalité est DXGK_FEATURE_CATEGORY_DRIVER. Pour plus d'informations, consultez la section Notes.
`DXGK_FEATURE_GPUVAIOMMU` Adresse virtuelle GPU avec la fonctionnalité IoMmu. La catégorie de fonctionnalité est DXGK_FEATURE_CATEGORY_DRIVER.
`DXGK_FEATURE_NATIVE_FENCE` Fonctionnalité de clôture GPU native. La catégorie de fonctionnalité est DXGK_FEATURE_CATEGORY_DRIVER.
`DXGK_FEATURE_QUERYSTATISTICS_EXTENSIONS` Fonctionnalité de statistiques de requête. La catégorie de fonctionnalité est DXGK_FEATURE_CATEGORY_OS.

Remarques

Une fonctionnalité WDDM est identifiée par son ID de fonctionnalité (DXGK_FEATURE_ID) composé des éléments suivants :

Valeur DXGK_FEATURE_CATEGORY qui identifie l’ID de catégorie de la fonctionnalité. Ces informations sont stockées dans les quatre bits supérieurs de DXGK_FEATURE_ID.
Valeur DXGK_DRIVER_FEATURE qui identifie la fonctionnalité elle-même.

Étant donné que les implémentations de fonctionnalités d’origine n’ont pas catégorisé les ID de fonctionnalité, il existe quelques ID de fonctionnalité qui doivent rester définis dans la catégorie 0 pour la compatibilité descendante, mais ne sont pas des fonctionnalités de pilote. Cela s’applique aux ID de fonctionnalité suivants :

DXGK_FEATURE_64K_PT_DEMOTION_FIX
DXGK_FEATURE_GPUPV_PRESENT_HWQUEUE
Tous les ID de fonctionnalité de la plage de DXGK_DRIVER_FEATURE_RESERVED_1 à DXGK_DRIVER_FEATURE_RESERVED_25

Ces ID de fonctionnalité représentent des fonctionnalités qui ont été définies ou implémentées sur des builds de système d’exploitation plus anciennes, et les vérifications logicielles existantes doivent pouvoir continuer à interroger ces fonctionnalités par ces ID. Les pilotes ne sont pas nécessaires pour implémenter la prise en charge d’un de ces ID de fonctionnalité.

Pour plus d’informations, consultez Interrogation de la prise en charge et de l’activation des fonctionnalités WDDM.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 11, version 24H2 (WDDM 3.2)
En-tête	d3dukmdt.h

Voir aussi

DXGK_DRIVER_FEATURE

DXGK_FEATURE_CATEGORY

Partager via