Функция GetXStateFeaturesMask (winbase.h)

Статья
03/03/2024

Возвращает маску функций XState, заданных в структуре CONTEXT .

Синтаксис

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

Параметры

[in] Context

Указатель на структуру CONTEXT , инициализированную с помощью InitializeContext.

[out] FeatureMask

Указатель на переменную, получающую маску признаков XState, которые присутствуют в указанной структуре CONTEXT .

Возвращаемое значение

Эта функция возвращает значение TRUE в случае успешного выполнения, в противном случае — FALSE.

Функция GetXStateFeaturesMask возвращает маску допустимых признаков в указанном контексте. Если необходимо передать CONTEXT в GetThreadContext или Wow64GetThreadContext, приложение должно вызвать SetXStateFeaturesMask , чтобы указать, какие функции необходимо извлечь. Затем следует вызвать GetXStateFeaturesMask в контексте, возвращаемом GetThreadContext или Wow64GetThreadContext, чтобы определить, какие области признаков содержат допустимые данные. Если определенный бит компонента не задан, соответствующее состояние находится в состоянии INITIALIZED для процессора, а содержимое области признаков, полученной методом LocateXStateFeature , не определено.

Определение функций XState зависит от поставщика процессора. Дополнительные сведения о конкретной функции см. в справочных руководствах по соответствующему процессору.

Примечание Значение, возвращаемое GetXStateFeaturesMask для context после контекстной операции, всегда будет подмножеством маски, указанной в вызове Метода SetXStateFeaturesMask до выполнения контекстной операции.

Windows 7 с пакетом обновления 1 (SP1) и Windows Server 2008 R2 с пакетом обновления 1 (SP1): API AVX впервые реализован в Windows 7 с пакетом обновления 1 (SP1) и Windows Server 2008 R2 с пакетом обновления 1 (SP1). Так как пакет SDK для с пакетом обновления 1 (SP1) отсутствует, это означает, что нет доступных заголовков и файлов библиотек для работы. В этом случае вызывающий объект должен объявить необходимые функции из этой документации и получить указатели на них с помощью GetModuleHandle на Kernel32.dll, а затем вызовы GetProcAddress. Дополнительные сведения см. в статье Работа с контекстом XState .

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 с пакетом обновления 1 (SP1) [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2 с пакетом обновления 1 (SP1) [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll