setXStateFeaturesMask 函数 (winbase.h)

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

语法

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

参数

[in, out] Context

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

[in] FeatureMask

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

返回值

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

注解

SetXStateFeaturesMask 函数设置指定上下文中有效功能的掩码。 在调用 GetThreadContextWow64GetThreadContextSetThreadContextWow64SetThreadContext 之前,应用程序必须调用 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

另请参阅

CONTEXT

GetThreadContext

Intel AVX

SetThreadContext

使用 XState 上下文

Wow64GetThreadContext

Wow64SetThreadContext