通过

CopyContext 函数 （winbase.h）

  • 项目

将源上下文结构（包括任何 XState）复制到初始化的目标上下文结构。

语法

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

参数

[in, out] Destination

指向 CONTEXT 结构的指针，该结构接收从 源复制的上下文。 调用此函数之前，应先调用 InitializeContext 来初始化 CONTEXT 结构。

[in] ContextFlags

指定将复制到目标的 SourceCONTEXT 结构的标志。 这必须是在 DestinationCONTEXT上调用 InitializeContext 时指定的 ContextFlags 的子集。

[in] Source

指向从中复制处理器上下文数据的 CONTEXT 结构的指针。

返回值

如果成功复制上下文，则此函数返回 TRUE;否则 FALSE。 若要获取扩展的错误信息，请调用 GetLastError。

言论

该函数从 源CONTEXTCONTEXT 复制 目标CONTEXT中的数据，包括扩展上下文（如果有）。 DestinationCONTEXT 必须使用 InitializeContext 进行初始化，以确保正确对齐和初始化。 如果 目标CONTEXT 中存在任何数据，并且未在 SourceCONTEXT 或 ContextFlags 参数中设置相应的标志，则数据在 目标中保持有效。

具有 SP1 和 Windows Server 2008 R2 的 Windows 7 SP1：AVX API 首先在 Windows 7 上实现 SP1 和具有 SP1 的 Windows Server 2008 R2。 由于没有适用于 SP1 的 SDK，这意味着没有可用的标头和库文件可供使用。 在这种情况下，调用方必须声明本文档中所需的函数，并使用 GetModuleHandle“Kernel32.dll”获取指向它们的指针，然后调用 getProcAddress。 有关详细信息，请参阅 使用 XState 上下文。

要求

要求 价值
最低支持的客户端 具有 SP1 的 Windows 7 [仅限桌面应用]
支持的最低服务器 Windows Server 2008 R2 SP1 [仅限桌面应用]
目标平台 窗户
标头 winbase.h （包括 Windows.h）
库 Kernel32.lib
DLL Kernel32.dll

另请参阅

CONTEXT

InitializeContext

Intel AVX

使用 XState 上下文