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

Статья
03/13/2024

Задает маску компонентов XState, заданных в структуре CONTEXT .

Синтаксис

BOOL SetXStateFeaturesMask(
  [in, out] PCONTEXT Context,
  [in]      DWORD64  FeatureMask
);

Параметры

[in, out] Context

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

[in] FeatureMask

Маска компонентов XState для задания в указанной структуре CONTEXT .

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

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

Функция SetXStateFeaturesMask задает маску допустимых признаков в указанном контексте. Перед вызовом GetThreadContext, Wow64GetThreadContext, SetThreadContext или Wow64SetThreadContext приложение должно вызвать 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) [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 с пакетом обновления 1 (SP1) [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll