GetXStateFeaturesMask 函数 (winbase.h)

项目
03/13/2024

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

语法

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

参数

[in] Context

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

[out] FeatureMask

指向变量的指针，该变量接收指定 CONTEXT 结构中存在的 XState 特征的掩码。

返回值

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

注解

GetXStateFeaturesMask 函数返回指定上下文中有效功能的掩码。如果要将 CONTEXT 传递给 GetThreadContext 或 Wow64GetThreadContext，则应用程序必须调用 SetXStateFeaturesMask 来设置要检索的功能。然后，应在 GetThreadContext 或 Wow64GetThreadContext 返回的 CONTEXT 上调用 GetXStateFeaturesMask，以确定哪些功能区域包含有效数据。如果未设置特定的功能位，则相应的状态处于特定于处理器的 INITIALIZED 状态，并且未定义由 LocateXStateFeature 检索的功能区域的内容。

XState 功能的定义特定于处理器供应商。有关特定功能的其他信息，请参阅相关处理器参考手册。

注意上下文操作后 ，GetXStateFeaturesMask 在 CONTEXT 上返回的值将始终是在上下文操作之前对 SetXStateFeaturesMask 的调用中指定的掩码的子集。

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 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2008 R2 SP1 [桌面应用 \|UWP 应用]
目标平台	Windows
标头	winbase.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll