Fungsi CopyContext (winbase.h)

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

Sintaksis

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

Parameter

[in, out] Destination

Penunjuk ke struktur KONTEKS yang menerima konteks yang disalin dariSumber . Struktur KONTEKS 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 padaKONTEKSTujuan .

[in] Source

Penunjuk ke struktur KONTEKS untuk menyalin data konteks prosesor.

Mengembalikan nilai

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

Komentar

Fungsi menyalin data dari KONTEKSSumber atas data yang sesuai diKONTEKS Destination, 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

Lihat juga

KONTEKS

InitializeContext

Intel AVX

Bekerja dengan Konteks XState