getXStateFeaturesMask 函式 (winbase.h)

發行項
03/03/2024

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

語法

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

參數

[in] Context

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

[out] FeatureMask

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

傳回值

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

備註

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

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

注意內容作業之後， GetXStateFeaturesMask 在 CONTEXT 上傳回的值，一律是內容作業之前對 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