CopyContext-Funktion (winbase.h)

Kopiert eine Quellkontextstruktur (einschließlich beliebiger XState) in eine initialisierte Zielkontextstruktur.

Syntax

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

Parameter

[in, out] Destination

Ein Zeiger auf eine CONTEXT-Struktur , die den aus der Quelle kopierten Kontext empfängt. Die CONTEXT-Struktur sollte initialisiert werden, indem InitializeContext aufgerufen wird, bevor diese Funktion aufgerufen wird.

[in] ContextFlags

Flags, die die Teile der Source CONTEXT-Struktur angeben, die in das Ziel kopiert werden. Dies muss eine Teilmenge der ContextFlags sein, die beim Aufrufen von InitializeContext für den ZielKONTEXT angegeben werden.

[in] Source

Ein Zeiger auf eine CONTEXT-Struktur , aus der Prozessorkontextdaten kopiert werden sollen.

Rückgabewert

Diese Funktion gibt TRUE zurück, wenn der Kontext erfolgreich kopiert wurde, andernfalls FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die Funktion kopiert Daten aus dem QuellKONTEXT über die entsprechenden Daten im ZielKONTEXT, einschließlich erweiterter Kontext, falls vorhanden. Der ZielKONTEXT muss mit InitializeContext initialisiert worden sein, um eine ordnungsgemäße Ausrichtung und Initialisierung sicherzustellen. Wenn Daten im ZielKONTEXT vorhanden sind und das entsprechende Flag nicht im QuellKONTEXT oder im ContextFlags-Parameter festgelegt ist, bleiben die Daten im Ziel gültig.

Windows 7 mit SP1 und Windows Server 2008 R2 mit SP1: Die AVX-API wird zuerst unter Windows 7 mit SP1 und Windows Server 2008 R2 mit SP1 implementiert. Da es kein SDK für SP1 gibt, bedeutet dies, dass keine Header und Bibliotheksdateien verfügbar sind, mit denen sie arbeiten können. In dieser Situation muss ein Aufrufer die erforderlichen Funktionen aus dieser Dokumentation deklarieren und Zeiger darauf mithilfe von GetModuleHandle auf „Kernel32.dll“ gefolgt von Aufrufen von GetProcAddress abrufen. Weitere Informationen finden Sie unter Arbeiten mit dem XState-Kontext .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

CONTEXT

InitializeContext

Intel AVX

Arbeiten mit XState-Kontext