Función LocateXStateFeature (winbase.h)

Recupera un puntero al estado del procesador para una característica XState dentro de una estructura CONTEXT.

La definición de bits de característica 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.

Sintaxis

PVOID LocateXStateFeature(
  [in]            PCONTEXT Context,
  [in]            DWORD    FeatureId,
  [out, optional] PDWORD   Length
);

Parámetros

[in] Context

Puntero a una estructura CONTEXT que contiene el estado que se va a recuperar o establecer. Este CONTEXT debe haberse inicializado con InitializeContext con la marca CONTEXT_XSTATE establecida en el parámetro ContextFlags .

[in] FeatureId

Número de la característica que se va a buscar dentro de la estructura CONTEXT .

[out, optional] Length

Puntero a una variable que recibe la longitud del área de características en bytes. El contenido de esta variable no está definido si esta función devuelve NULL.

Valor devuelto

Si el sistema admite la característica especificada y la estructura CONTEXT especificada se ha inicializado con la marca CONTEXT_XSTATE , esta función devuelve un puntero al área de características de la característica especificada. El contenido y el diseño de esta área son específicos del procesador.

Si la marca CONTEXT_XSTATE no está establecida en la estructura CONTEXT o el FeatureID no es compatible con el sistema, el valor devuelto es NULL. No hay información adicional de error disponible.

Comentarios

La función LocateXStateFeature debe usarse para buscar una característica XState individual dentro de una estructura CONTEXT extensible. Las características no son necesariamente contiguas en la memoria y las aplicaciones no deben suponer que el desplazamiento entre dos características consecutivas permanecerá constante en el futuro.

El parámetro FeatureID de la función corresponde a un poco dentro de la máscara de características. Por ejemplo, FeatureId 2 corresponde a featureMask de 4 en SetXStateFeaturesMask. Los valores featureID de 0 y 1 corresponden al estado de FPU X87 y al estado SSE, respectivamente.

Si va a establecer XState en un subproceso a través de las API SetThreadContext o Wow64SetThreadContext , también debe llamar a SetXStateFeaturesMask en la estructura CONTEXT con el valor de máscara de la característica rellenada para marcar la característica como activa.

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

Vea también

CONTEXT

Intel AVX

SetThreadContext

SetXStateFeaturesMask

Trabajo con el contexto XState

Wow64SetThreadContext