Поделиться через


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

Задает маску компонентов 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

См. также

КОНТЕКСТЕ

GetThreadContext

Intel AVX

SetThreadContext

Работа с контекстом XState

Wow64GetThreadContext

Wow64SetThreadContext