Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Devuelve la máscara de las características XState establecidas dentro de una estructura CONTEXT .
Sintaxis
BOOL GetXStateFeaturesMask(
[in] PCONTEXT Context,
[out] PDWORD64 FeatureMask
);
Parameters
[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.
Observaciones
La función GetXStateFeaturesMask devuelve la máscara de características válidas en el contexto especificado. Si se va a pasar un CONTEXTO a GetThreadContext o Wow64GetThreadContext, la aplicación debe llamar a SetXStateFeaturesMask para establecer qué características se van a recuperar. GetXStateFeaturesMask debe llamarse a 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 encabezados y archivos de biblioteca disponibles con los que trabajar. En esta situación, un autor de la llamada debe declarar las funciones necesarias de esta documentación y obtener punteros a ellos 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
| Requirement | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 con SP1 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo admitido | Windows Server 2008 R2 con SP1 [aplicaciones de escritorio | Aplicaciones para UWP] |
| de la plataforma de destino de | Windows |
| Encabezado | winbase.h (incluya Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL de | Kernel32.dll |