共用方式為


getXStateFeaturesMask 函式 (winbase.h)

傳回 CONTEXT 結構內所設定之 XState 功能的遮罩。

語法

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

參數

[in] Context

已使用 InitializeContext 初始化之 CONTEXT 結構的指標。

[out] FeatureMask

變數的指標,接收出現在指定 CONTEXT 結構中的 XState 特徵遮罩。

傳回值

如果成功,則此函式會傳回 TRUE ,否則傳回 FALSE

備註

GetXStateFeaturesMask 函式會傳回指定內容中有效功能的遮罩。 如果要將 CONTEXT 傳遞至 GetThreadContextWow64GetThreadContext,應用程式必須呼叫 SetXStateFeaturesMask 來設定要擷取的功能。 GetXStateFeaturesMask 應該接著在 GetThreadContextWow64GetThreadContext 傳回的 CONTEXT 上呼叫,以判斷哪些功能區域包含有效的數據。 如果未設定特定功能位,對應的狀態會處於處理器特定的 INITIALIZED 狀態,而且 未定義 LocateXStateFeature 所擷取的功能區域內容。

XState 功能的定義是處理器廠商特定的。 如需特定功能的其他資訊,請參閱相關的處理器參考手冊。

注意 內容作業之後, GetXStateFeaturesMaskCONTEXT 上傳回的值,一律是內容作業之前 對 SetXStateFeaturesMask 呼叫中指定的遮罩子集。
 

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 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 SP1 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

上下文

GetThreadContext

Intel AVX

SetXStateFeaturesMask

使用 XState 內容

Wow64GetThreadContext