Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 renvoyé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és 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 processeurs. Reportez-vous aux manuels de référence pertinents du processeur pour plus d’informations sur une fonctionnalité particulière.
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 aucun kit 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 ceux-ci à l’aide de GetModuleHandle sur «Kernel32.dll», suivi d’appels à GetProcAddress. Pour plus d’informations, consultez Utilisation du contexte XState .
Exigences
| Requirement | Valeur |
|---|---|
| Client minimum requis | 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 |