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 函式會設定指定內容中有效功能的遮罩。 呼叫 GetThreadContext、Wow64GetThreadContext、SetThreadContext 或 Wow64SetThreadContext 之前，應用程式必須呼叫 SetXStateFeaturesMask 來指定要擷取或設定哪些功能集。 系統會以無訊息方式忽略在處理器上未啟用 之FeatureMask 中指定的任何功能。
Windows 7 SP1 和 Windows Server 2008 R2 SP1： AVX API 會先在 Windows 7 上實作 SP1 和 Windows Server 2008 R2 SP1 。 由於沒有適用於SP1的SDK，這表示沒有可用的標頭和連結庫檔案可供使用。 在此情況下，呼叫端必須從本檔宣告所需的函式，並使用 「Kernel32.dll」 上的 GetModuleHandle 取得這些函式的指標，後面接著呼叫 GetProcAddress。 如需詳細資訊，請參閱 使用 XState 內容 。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 7 SP1 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 SP1 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winbase.h (包含 Windows.h) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |