Función CopyContext (winbase.h)

Copia una estructura de contexto de origen (incluida cualquier XState) en una estructura de contexto de destino inicializada.

Sintaxis

BOOL CopyContext(
  [in, out] PCONTEXT Destination,
  [in]      DWORD    ContextFlags,
  [in]      PCONTEXT Source
);

Parámetros

[in, out] Destination

Puntero a una estructura CONTEXT de que recibe el contexto copiado delsource de . La estructura CONTEXT de debe inicializarse llamando a initializeContext antes de llamar a esta función.

[in] ContextFlags

Marcas que especifican las partes del SourceCONTEXT estructura que se copiará en el destino. Debe ser un subconjunto del ContextFlags de especificado al llamar a initializeContext en el DestinationCONTEXT.

[in] Source

Puntero a una estructura de CONTEXT desde la que se van a copiar los datos de contexto del procesador.

Valor devuelto

Esta función devuelve TRUE si el contexto se copió correctamente; de lo contrario, FALSE. Para obtener información de error extendida, llame a GetLastError.

Observaciones

La función copia los datos de la origenCONTEXT sobre los datos correspondientes en la DestinationCONTEXT, incluido el contexto extendido si existe alguno. El CONTEXTdestination debe haberse inicializado con initializeContext para garantizar la alineación y la inicialización adecuadas. Si algún dato está presente en el contextdestination y la marca correspondiente no está establecida en el contextsourceo en el parámetro contextFlags de , los datos permanecen válidos en el Destination.

Windows 7 con SP1 y Windows Server 2008 R2 con SP1: La API de AVX de 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 llamador 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 Trabajar con contexto XState para obtener más información.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 7 con SP1 [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 R2 con SP1 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de winbase.h (incluya Windows.h)
biblioteca de Kernel32.lib
DLL de Kernel32.dll

Consulte también

CONTEXT de

initializeContext

intel AVX

trabajar con de contexto XState