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 lesquelles des fonctionnalités expérimentales disponibles doivent être activées. pConfigurationStructs [in]
Type : void *
SAL : __in_ecount(NumFeatures) Structures qui contiennent des détails de configuration supplémentaires dont certaines fonctionnalités expérimentales pourraient 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 de réussite ou d’erreur HRESULT qui peut inclure 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. Comme l’ensemble des fonctionnalités expérimentales changera au fil du temps, et comme 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 que des fonctionnalités expérimentales puissent être activées. 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 rendues disponibles 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 de nouveau avec une liste différente de fonctionnalités à activer, tous les appareils D3D12 actuels sont mis 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 6 octobre 2026