Fonction SetXStateFeaturesMask (winbase.h)

Article
03/03/2024

Définit le masque des fonctionnalités XState définies dans une structure CONTEXT.

Syntaxe

BOOL SetXStateFeaturesMask(
  [in, out] PCONTEXT Context,
  [in]      DWORD64  FeatureMask
);

Paramètres

[in, out] Context

Pointeur vers une structure CONTEXT qui a été initialisée avec InitializeContext.

[in] FeatureMask

Masque des fonctionnalités XState à définir dans la structure CONTEXT spécifiée.

Valeur retournée

Cette fonction retourne TRUE si elle réussit, sinon FALSE.

Remarques

La fonction SetXStateFeaturesMask définit le masque des fonctionnalités valides dans le contexte spécifié. Avant d’appeler GetThreadContext, Wow64GetThreadContext, SetThreadContext ou Wow64SetThreadContext , l’application doit appeler SetXStateFeaturesMask pour spécifier l’ensemble de fonctionnalités à récupérer ou à définir. Le système ignore en mode silencieux toute fonctionnalité spécifiée dans FeatureMask qui n’est pas activée sur le processeur.

Windows 7 avec SP1 et Windows Server 2008 R2 avec SP1 : L’API AVX est d’abord implémentée sur Windows 7 avec SP1 et Windows Server 2008 R2 avec SP1 . Étant donné qu’il n’existe pas de KIT de développement logiciel (SDK) pour SP1, cela signifie qu’il n’y a pas d’en-têtes et de fichiers de bibliothèque disponibles à utiliser. Dans ce cas, un appelant doit déclarer les fonctions nécessaires à partir de cette documentation et obtenir des pointeurs vers celles-ci à l’aide de GetModuleHandle sur « Kernel32.dll », puis effectuer des appels à GetProcAddress. Pour plus d’informations, consultez Utilisation du contexte XState .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 avec SP1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll