Passer au contenu principal
Active une liste de fonctionnalités expérimentales.

Syntaxe

Paramètres

NumFeatures
Type : UINT
Nombre de fonctionnalités expérimentales à activer. pIIDs [in]
Type : const IID *
SAL : __in_ecount(NumFeatures) Pointeur vers un tableau d’ID qui spécifient les fonctionnalités expérimentales disponibles à activer. pConfigurationStructs [in]
Type : void *
SAL : __in_ecount(NumFeatures) Structures qui contiennent des détails de configuration supplémentaires dont certaines fonctionnalités expérimentales peuvent avoir besoin pour être activées. pConfigurationStructSizes [in]
Type : UINT *
SAL : __in_ecount(NumFeatures) Tailles des structures de configuration passées dans le paramètre pConfigurationStructs.

Valeur de retour

Type : HRESULT Cette méthode retourne un code HRESULT de réussite ou d’erreur, qui peut être E_NOINTERFACE si une fonctionnalité non reconnue est spécifiée ou si le mode développeur n’est pas activé, ou E_INVALIDARG si la configuration d’une fonctionnalité est incorrecte, si les fonctionnalités expérimentales spécifiées ne sont pas compatibles, ou en cas d’autres erreurs.

Remarques

Appelez cette fonction avant la création de l’appareil. Étant donné que l’ensemble des fonctionnalités expérimentales évoluera au fil du temps et que ces fonctionnalités peuvent ne pas être stables, elles sont destinées uniquement au développement et à l’expérimentation. Cela est imposé en exigeant que le mode développeur soit actif avant de pouvoir activer des fonctionnalités expérimentales. L’ensemble des fonctionnalités expérimentales actuellement prises en charge se trouve dans l’en-tête D3D12.h, près de la définition de la fonction D3D12EnableExperimentalFeatures ; comme les fonctionnalités expérimentales ne sont mises à disposition que rarement, il est courant de constater qu’aucune fonctionnalité expérimentale n’est actuellement prise en charge. Certaines fonctionnalités expérimentales peuvent être identifiées en utilisant un IID comme GUID. Pour ces fonctionnalités, vous pouvez utiliser D3D12GetDebugInterface, en passant un IID comme paramètre, pour récupérer l’interface permettant de manipuler cette fonctionnalité. Si cette fonction est appelée à nouveau avec une liste différente de fonctionnalités à activer, tous les appareils D3D12 actuels sont placés dans l’état DEVICE_REMOVED.

Exemples

Cet exemple montre à quoi ressemble la définition d’une fonctionnalité expérimentale.

Configuration requise

En-tête : d3d12_xs.h ou d3d12_x.h
Bibliothèque : d3d12_xs.lib ou d3d12_x.lib
Plateformes prises en charge : consoles XBOX Series et famille XBOX One

Voir aussi

Fonctions principales
Dernière modification le 19 octobre 2026