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

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

Syntax

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

Parameters

[in] Context

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

[out] FeatureMask

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

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

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

Замечания

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

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

Примечание Значение, возвращаемое GetXStateFeaturesMask в КОНТЕКСТе после операции контекста, всегда будет подмножеством маски, указанной в вызове 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 ".

Требования

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

См. также

CONTEXT

GetThreadContext

Intel AVX

SetXStateFeaturesMask

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

Wow64GetThreadContext

  • Last updated on