共用方式為

copyContext 函式 (winbase.h)

  • 發行項

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

語法

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

參數

[in, out] Destination

內容結構的指標，可接收從來源複製的內容。 在呼叫此函式之前，應該先呼叫 InitializeContext 來初始化 CONTEXT 結構。

[in] ContextFlags

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

[in] Source

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

傳回值

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

備註

函式會將 源內容 中的數據複製到 目的地內容中的對應數據，包括如果有的話，包括擴充內容。 目的地CONTEXT 必須使用InitializeContext初始化，以確保正確對齊和初始化。 如果目的地內容中有任何數據，且未在SourceCONTEXT或ContextFlags參數中設定對應的旗標，則數據仍會在 Destination 中維持有效狀態。

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

規格需求

需求 值
最低支援的用戶端 Windows 7 SP1 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 SP1 [僅限傳統型應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

上下文

InitializeContext

Intel AVX

使用 XState 內容