EnableProcessOptionalXStateFeatures 函式 （winbase.h）

此功能會為目前進程啟用一組可選的 XState 功能。

語法

BOOL EnableProcessOptionalXStateFeatures(
  DWORD64 Features
);

參數

Features

位遮罩，其中每個位代表可選的 XState 功能，以啟用目前的進程。

返回值

如果函式成功，則傳回值為非零值。

如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

一般而言，依預設會針對新建立的執行緒停用選用 XState 功能，並在稍後視需要啟用。 當此函式傳回時，將會針對目前進程中的所有現有執行緒啟用指定的選擇性 XState 功能，而在處理程序中建立的所有未來執行緒都會在執行緒建立時啟用指定的選擇性 XState 功能。

只允許將系統支援的 XState 功能位提供給此函式，否則會傳回錯誤。 系統支援的 XState 功能位可以透過 GetEnabledXStateFeatures 常式取得。 如果提供系統支援的非選擇性 XState 功能位 （例如 AVX、AVX2 等是非選擇性 XState 功能） ，則會忽略這些功能，而且不會導致此函式傳回錯誤。 請注意，根據預設，系統支援的所有非選擇性 XState 功能一律會針對每個執行緒啟用。

需求

另請參閱

GetEnabledXState功能

GetThreadEnabledXState功能