回傳 CONTEXT 結構中設定的 XState 特徵遮罩。
語法
BOOL GetXStateFeaturesMask(
[in] PCONTEXT Context,
[out] PDWORD64 FeatureMask
);
Parameters
[in] Context
一個指向已初始化為 InitializeContext 的 CONTEXT 結構的指標。
[out] FeatureMask
一個指標指向變數，接收指定 CONTEXT 結構中存在的 XState 特徵遮罩。
返回值
如果成功，此函式會傳回 TRUE ，否則會傳回 FALSE。
備註
GetXStateFeaturesMask 函式會回傳指定上下文中有效特徵的遮罩。 若要將 CONTEXT 傳給 GetThreadContext 或 Wow64GetThreadContext，應用程式必須呼叫 SetXStateFeaturesMask 來設定要擷取哪些特徵。 接著應呼叫 GetXStateFeaturesMask，根據 GetThreadContext 或 Wow64GetThreadContext 回傳的 CONTEXT，以判斷哪些特徵區域包含有效資料。 若未設定特定特徵位元，對應狀態為處理器專屬的 初始化 狀態， 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 with SP1 [桌面應用程式 |UWP 應用程式] |
| 目標平臺 | Windows 作業系統 |
| 標頭 | winbase.h （包括 Windows.h） |
| 範本庫 | Kernel32.lib |
| DLL | Kernel32.dll |