Compartir a través de


Función SetXStateFeaturesMask (winbase.h)

Establece la máscara de las características XState definidas dentro de una estructura CONTEXT.

Sintaxis

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

Parámetros

[in, out] Context

Puntero a una estructura CONTEXT que se ha inicializado con InitializeContext.

[in] FeatureMask

Máscara de las características XState que se van a establecer en la estructura CONTEXT especificada.

Valor devuelto

Esta función devuelve TRUE si se ejecuta correctamente; en caso contrario, FALSE.

Comentarios

La función SetXStateFeaturesMask establece la máscara de características válidas en el contexto especificado. Antes de llamar a GetThreadContext, Wow64GetThreadContext, SetThreadContext o Wow64SetThreadContext , la aplicación debe llamar a SetXStateFeaturesMask para especificar qué conjunto de características se van a recuperar o establecer. El sistema omite silenciosamente cualquier característica especificada en featureMask que no está habilitada en el procesador.

Windows 7 con SP1 y Windows Server 2008 R2 con SP1: La API de AVX se implementa primero en Windows 7 con SP1 y Windows Server 2008 R2 con SP1 . Puesto que no hay ningún SDK para SP1, significa que no hay encabezados y archivos de biblioteca disponibles con los que trabajar. En esta situación, el autor de la llamada debe declarar las funciones necesarias de esta documentación y obtener punteros a ellas mediante GetModuleHandle en "Kernel32.dll", seguido de llamadas a GetProcAddress. Consulte Working with XState Context (Trabajar con el contexto XState ) para obtener más información.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

CONTEXT

GetThreadContext

Intel AVX

SetThreadContext

Trabajo con el contexto XState

Wow64GetThreadContext

Wow64SetThreadContext