SetXStateFeaturesMask 函式 (winbase.h)

發行項
03/13/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 會先在 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