Fungsi CopyContext (winbase.h)

Menyalin struktur konteks sumber (termasuk XState apa pun) ke struktur konteks tujuan yang diinisialisasi.

Sintaks

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

Parameter

[in, out] Destination

Penunjuk ke struktur CONTEXT yang menerima konteks yang disalin dari Sumber. Struktur CONTEXT harus diinisialisasi dengan memanggil InitializeContext sebelum memanggil fungsi ini.

[in] ContextFlags

Bendera yang menentukan potongan struktur KONTEKSSumber yang akan disalin ke tujuan. Ini harus merupakan subset dari ContextFlags yang ditentukan saat memanggil InitializeContext pada KONTEKS Tujuan.

[in] Source

Penunjuk ke struktur CONTEXT untuk menyalin data konteks prosesor.

Nilai kembali

Fungsi ini mengembalikan TRUE jika konteks berhasil disalin, jika tidak FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi menyalin data dari KONTEKSSumber melalui data terkait dalam KONTEKSTujuan, termasuk konteks yang diperluas jika ada. KONTEKSTujuan harus diinisialisasi dengan InitializeContext untuk memastikan perataan dan inisialisasi yang tepat. Jika ada data yang ada di KONTEKSTujuan dan bendera yang sesuai tidak diatur dalam KONTEKSSumber atau dalam parameter ContextFlags, data tetap valid di Tujuan.

Windows 7 dengan SP1 dan Windows Server 2008 R2 dengan SP1: API AVX pertama kali diimplementasikan pada Windows 7 dengan SP1 dan Windows Server 2008 R2 dengan SP1 . Karena tidak ada SDK untuk SP1, itu berarti tidak ada header dan file pustaka yang tersedia untuk dikerjakan. Dalam situasi ini, penelepon harus mendeklarasikan fungsi yang diperlukan dari dokumentasi ini dan mendapatkan pointer kepada mereka menggunakan GetModuleHandle pada "Kernel32.dll", diikuti dengan panggilan ke GetProcAddress. Lihat Bekerja dengan Konteks XState untuk detailnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 dengan SP1 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 dengan SP1 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

KONTEKS

InitializeContext

Intel AVX

Bekerja dengan Konteks XState