CopyContext-Funktion (winbase.h)
Kopiert eine Quellkontextstruktur (einschließlich eines beliebigen 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 Sourcekopierten Kontext empfängt. Die CONTEXT--Struktur sollte initialisiert werden, indem InitializeContext- aufgerufen wird, bevor Sie diese Funktion aufrufen.
[in] ContextFlags
Flags, die die Teile der SourceCONTEXT Struktur angeben, die in das Ziel kopiert wird. Dies muss eine Teilmenge der ContextFlags sein, die beim Aufrufen InitializeContext- für das DestinationCONTEXT-angegeben wird.
[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. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Die Funktion kopiert Daten aus der SourceCONTEXT über die entsprechenden Daten im DestinationCONTEXT, einschließlich des erweiterten Kontexts, falls vorhanden. Die DestinationCONTEXT- muss mit InitializeContext- initialisiert worden sein, um eine ordnungsgemäße Ausrichtung und Initialisierung sicherzustellen. Wenn daten im DestinationCONTEXT vorhanden sind und das entsprechende Flag nicht im SourceCONTEXT oder im ContextFlags Parameter festgelegt ist, bleiben die Daten im Destinationgü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 es keine verfügbaren Header- und Bibliotheksdateien gibt, mit denen sie arbeiten können. In diesem Fall muss ein Aufrufer die erforderlichen Funktionen aus dieser Dokumentation deklarieren und Zeiger mit GetModuleHandle- für "Kernel32.dll" abrufen, gefolgt von Aufrufen von GetProcAddress. Weitere Informationen finden Sie unter Arbeiten mit XState Context.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 7 mit SP1 [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 R2 mit SP1 [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winbase.h (enthalten Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |