CopyContext, fonction (winbase.h)
Copie une structure de contexte source (y compris tout XState) dans une structure de contexte de destination initialisée.
Syntaxe
BOOL CopyContext(
[in, out] PCONTEXT Destination,
[in] DWORD ContextFlags,
[in] PCONTEXT Source
);
Paramètres
[in, out] Destination
Pointeur vers une structure CONTEXT qui reçoit le contexte copié à partir de la source. La structure CONTEXT doit être initialisée en appelant InitializeContext avant d’appeler cette fonction.
[in] ContextFlags
Indicateurs spécifiant les éléments de la structure SOURCECONTEXT qui seront copiés dans la destination. Il doit s’agir d’un sous-ensemble des ContextFlags spécifiés lors de l’appel d’InitializeContext sur le CONTEXTE dedestination.
[in] Source
Pointeur vers une structure CONTEXT à partir de laquelle copier les données de contexte du processeur.
Valeur retournée
Cette fonction retourne TRUE si le contexte a été copié avec succès, sinon FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
La fonction copie les données du CONTEXTEsource sur les données correspondantes dans le CONTEXTE de destination, y compris le contexte étendu le cas échéant. Le CONTEXTEde destination doit avoir été initialisé avec InitializeContext pour garantir l’alignement et l’initialisation appropriés. Si des données sont présentes dans le CONTEXTE dedestination et que l’indicateur correspondant n’est pas défini dans le contextesource ou dans le paramètre ContextFlags, les données restent valides dans la destination.
Windows 7 avec SP1 et Windows Server 2008 R2 avec SP1 : L’API AVX est d’abord implémentée sur Windows 7 avec SP1 et Windows Server 2008 R2 avec SP1 . Étant donné qu’il n’existe aucun kit SDK pour SP1, cela signifie qu’il n’y a pas d’en-têtes et de fichiers de bibliothèque disponibles à utiliser. Dans ce cas, un appelant doit déclarer les fonctions nécessaires à partir de cette documentation et obtenir des pointeurs vers celles-ci à l’aide de GetModuleHandle sur « Kernel32.dll », puis effectuer des appels à GetProcAddress. Pour plus d’informations, consultez Utilisation du contexte XState .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 avec SP1 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 avec SP1 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winbase.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |