共用方式為

CopyContext 函式 （winbase.h）

  • 發行項

將來源內容結構（包括任何 XState）複製到初始化的目的地內容結構。

語法

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

參數

[in, out] Destination

CONTEXT 結構的指標，這個結構會接收從 Source複製的內容。 呼叫 InitializeContext 之前，應該先呼叫 CONTEXT 結構來初始化。

[in] ContextFlags

旗標，指定將複製到目的地的 SourceCONTEXT 結構片段。 這必須是在 DestinationCONTEXT上 呼叫 initializeContext 時所指定的 ContextFlag s 子集。

[in] Source

要從中複製處理器內容數據的 CONTEXT 結構的指標。

傳回值

如果成功複製內容，則此函式會傳回 TRUE TRUE，否則 FALSE。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

函式會將數據從 SourceCONTEXT 複製到 DestinationCONTEXT中的對應數據，包括如果有的話，包括擴充內容。 DestinationCONTEXT 必須已使用 initializeContext 初始化，以確保正確對齊和初始化。 如果 DestinationCONTEXT 中有任何數據存在，且對應旗標未設定於 SourceCONTEXT 或 ContextFlags 參數中，則數據在 Destination中仍然有效。

Windows 7 SP1 和 Windows Server 2008 R2 SP1：AVX API 會先在 Windows 7 上實作 SP1 和 Windows Server 2008 R2 SP1 。 由於沒有適用於SP1的SDK，這表示沒有可用的標頭和連結庫檔案可供使用。 在此情況下，呼叫端必須從本檔宣告所需的函式，並使用 GetModuleHandle on “Kernel32.dll”，接著 呼叫 getProcAddress。 如需詳細資訊，請參閱 使用 XState 內容。

要求

要求 價值
最低支援的用戶端 Windows 7 SP1 [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2008 R2 SP1 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 winbase.h （包括 Windows.h）
連結庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

CONTEXT

InitializeContext

Intel AVX

使用 XState 內容