GetXStateFeaturesMask, fonction (winbase.h)

Article
03/03/2024

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

Syntaxe

BOOL GetXStateFeaturesMask(
  [in]  PCONTEXT Context,
  [out] PDWORD64 FeatureMask
);

Paramètres

[in] Context

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

[out] FeatureMask

Pointeur vers une variable qui reçoit le masque des fonctionnalités XState présentes dans la structure CONTEXT spécifiée.

Valeur retournée

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

Remarques

La fonction GetXStateFeaturesMask retourne le masque des fonctionnalités valides dans le contexte spécifié. Si un CONTEXT doit être passé à GetThreadContext ou Wow64GetThreadContext, l’application doit appeler SetXStateFeaturesMask pour définir les fonctionnalités à récupérer. GetXStateFeaturesMask doit ensuite être appelé sur le CONTEXT retourné par GetThreadContext ou Wow64GetThreadContext pour déterminer quelles zones de fonctionnalité contiennent des données valides. Si un bit de fonctionnalité particulier n’est pas défini, l’état correspondant se trouve dans un état INITIALIZED spécifique au processeur et le contenu de la zone de fonctionnalité récupérée par LocateXStateFeature n’est pas défini.

La définition des fonctionnalités XState est spécifique au fournisseur de processeur. Pour plus d’informations sur une fonctionnalité particulière, consultez les manuels de référence du processeur appropriés.

Note La valeur retournée par GetXStateFeaturesMask sur un CONTEXT après une opération de contexte sera toujours un sous-ensemble du masque spécifié dans un appel à SetXStateFeaturesMask avant l’opération de contexte.

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 \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 avec SP1 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll