setXStateFeaturesMask 函数 (winbase.h)

项目
03/03/2024

返回在 CONTEXT 结构中设置的 XState 功能的掩码。

语法

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

参数

[in, out] Context

指向已使用 InitializeContext 初始化的 CONTEXT 结构的指针。

[in] FeatureMask

在指定的 CONTEXT 结构中设置的 XState 功能的掩码。

返回值

如果成功，此函数返回 TRUE ，否则返回 FALSE。

注解

SetXStateFeaturesMask 函数设置指定上下文中有效功能的掩码。在调用 GetThreadContext、 Wow64GetThreadContext、 SetThreadContext 或 Wow64SetThreadContext 之前，应用程序必须调用 SetXStateFeaturesMask 来指定要检索或设置的功能集。系统以无提示方式忽略 FeatureMask 中指定的任何未在处理器上启用的功能。

Windows 7 SP1 和 Windows Server 2008 R2 SP1： AVX API 首先在带有 SP1 的 Windows 7 和带有 SP1 的 Windows Server 2008 R2 上实现。由于没有 SP1 的 SDK，这意味着没有可用的标头和库文件可供使用。在这种情况下，调用方必须声明本文档中所需的函数，并在“Kernel32.dll”上使用 GetModuleHandle 获取指向这些函数的指针，然后调用 GetProcAddress。有关详细信息，请参阅使用 XState 上下文。

要求

要求	值
最低受支持的客户端	Windows 7 SP1 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 SP1 [仅限桌面应用]
目标平台	Windows
标头	winbase.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll