EnableProcessOptionalXStateFeatures, fonction (winbase.h)

Cette fonction active un ensemble de fonctionnalités XState facultatives pour le processus actuel.

Syntaxe

BOOL EnableProcessOptionalXStateFeatures(
  DWORD64 Features
);

Paramètres

Features

Masque de bits dans lequel chaque bit représente une fonctionnalité XState facultative à activer pour le processus actuel.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

En général, les fonctionnalités XState facultatives sont désactivées par défaut pour les threads nouvellement créés et activées à la demande ultérieurement. Lorsque cette fonction est retournée, les fonctionnalités XState facultatives spécifiées sont activées pour tous les threads existants dans le processus actuel, et tous les threads futurs créés dans le processus auront les fonctionnalités XState facultatives spécifiées activées au moment de la création du thread.

Seuls les bits de fonctionnalité XState pris en charge par le système sont autorisés à être fournis à cette fonction, sinon une erreur est retournée. Les bits de fonctionnalité XState pris en charge par le système peuvent être obtenus via la routine GetEnabledXStateFeatures . Si les bits de fonctionnalité XState non facultatifs pris en charge par le système sont fournis (par exemple AVX, AVX2, etc. sont des fonctionnalités XState non facultatives), celles-ci sont ignorées et ne provoquent pas de retour d’erreur. Notez que toutes les fonctionnalités XState non facultatives prises en charge par le système sont toujours activées pour chaque thread par défaut.

Spécifications

Voir aussi

GetEnabledXStateFeatures

GetThreadEnabledXStateFeatures