Функция CopyContext (winbase.h)

Копирует исходную структуру контекста (включая любой XState) в инициализированную структуру контекста назначения.

Синтаксис

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

Параметры

[in, out] Destination

Указатель на структуру контекста , которая получает контекст, скопированный из исходного. Структура CONTEXT должна быть инициализирована путем вызова InitializeContext перед вызовом этой функции.

[in] ContextFlags

Флаги, указывающие части исходногоCONTEXT структуры, которая будет скопирована в место назначения. Это должно быть подмножество ContextFlags , указанное при вызове InitializeContext в destinationCONTEXT.

[in] Source

Указатель на структуру CONTEXT, из которой копируются данные контекста процессора.

Возвращаемое значение

Эта функция возвращает TRUE, если контекст был успешно скопирован, в противном случае FALSE. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Функция копирует данные из sourceCONTEXT над соответствующими данными в конечнойCONTEXT, включая расширенный контекст при наличии. Необходимо инициализироватьназначенияCONTEXT с помощью InitializeContext, чтобы обеспечить правильное выравнивание и инициализацию. Если какие-либо данные присутствуют вdestinationCONTEXT и соответствующий флаг не задан в источникеCONTEXT или в параметре ContextFlags, данные остаются действительными в целевом.

Windows 7 с пакетом обновления 1 (SP1) и Windows Server 2008 R2 с пакетом обновления 1 (SP1): API AVX впервые реализованы в Windows 7 с пакетом обновления 1 (SP1) и Windows Server 2008 R2 с пакетом обновления 1 (SP1). Так как для пакета SDK для пакета обновления 1 (SP1) нет доступных заголовков и файлов библиотек для работы. В этой ситуации вызывающий объект должен объявить необходимые функции из этой документации и получить указатели на них с помощью GetModuleHandle на "Kernel32.dll", а затем вызовы GetProcAddress. Дополнительные сведения см. в работе с контекстом XState.

Требования

См. также

CONTEXT

InitializeContext

Intel AVX

Работа с контекстом XState