Función GetXStateFeaturesMask (winbase.h)

Artículo
08/27/2023

Devuelve la máscara de las características XState establecidas dentro de una estructura CONTEXT.

Sintaxis

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

Parámetros

[in] Context

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

[out] FeatureMask

Puntero a una variable que recibe la máscara de las características XState que están presentes en la estructura CONTEXT especificada.

Valor devuelto

Esta función devuelve TRUE si se ejecuta correctamente; de lo contrario, FALSE.

Comentarios

La función GetXStateFeaturesMask devuelve la máscara de características válidas en el contexto especificado. Si se va a pasar un CONTEXT a GetThreadContext o Wow64GetThreadContext, la aplicación debe llamar a SetXStateFeaturesMask para establecer qué características se van a recuperar. GetXStateFeaturesMask debe llamarse en el CONTEXTO devuelto por GetThreadContext o Wow64GetThreadContext para determinar qué áreas de características contienen datos válidos. Si no se establece un bit de característica determinado, el estado correspondiente se encuentra en un estado INITIALIZED específico del procesador y el contenido del área de características recuperada por LocateXStateFeature no está definida.

La definición de las características XState es específica del proveedor del procesador. Consulte los manuales de referencia del procesador pertinentes para obtener información adicional sobre una característica determinada.

Nota El valor devuelto por GetXStateFeaturesMask en un CONTEXTO después de una operación de contexto siempre será un subconjunto de la máscara especificada en una llamada a SetXStateFeaturesMask antes de la operación de contexto.

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 ningún encabezado 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 [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2 con SP1 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	winbase.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll