LocateXStateFeature 函数 (winbase.h)

项目
03/09/2024

检索指向 CONTEXT 结构中 XState 功能的处理器状态的指针。

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

语法

PVOID LocateXStateFeature(
  [in]            PCONTEXT Context,
  [in]            DWORD    FeatureId,
  [out, optional] PDWORD   Length
);

参数

[in] Context

指向包含要检索或设置的状态的 CONTEXT 结构的指针。此上下文应已使用 InitializeContext 进行初始化，并在 ContextFlags 参数中设置了CONTEXT_XSTATE标志。

[in] FeatureId

在 CONTEXT 结构中查找的功能编号。

[out, optional] Length

指向变量的指针，该变量接收特征区域的长度（以字节为单位）。如果此函数返回 NULL，则此变量的内容未定义。

返回值

如果系统支持指定的功能，并且指定的 CONTEXT 结构已使用 CONTEXT_XSTATE 标志进行初始化，则此函数将返回指向指定特征的特征区域的指针。此区域的内容和布局特定于处理器。

如果未在 CONTEXT 结构中设置CONTEXT_XSTATE标志，或者系统不支持 FeatureID，则返回值为 NULL。没有其他错误信息可用。

注解

必须使用 LocateXStateFeature 函数在可扩展的 CONTEXT 结构中查找单个 XState 功能。特征在内存中不一定是连续的，应用程序不应假定两个连续特征之间的偏移量将来保持不变。

函数的 FeatureID 参数对应于特征掩码中的一个位。例如，FeatureId 2 对应于 SetXStateFeaturesMask 中的 FeatureMask 为 4。 FeatureID 值为 0 和 1 分别对应于 X87 FPU 状态和 SSE 状态。

如果要通过 SetThreadContext 或 Wow64SetThreadContext API 在线程上设置 XState，还必须使用填充功能的掩码值在 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