InitializeContext, fonction (winbase.h)

Initialise une structure CONTEXT à l’intérieur d’une mémoire tampon avec la taille et l’alignement nécessaires.

Syntaxe

BOOL InitializeContext(
  [out, optional] PVOID    Buffer,
  [in]            DWORD    ContextFlags,
  [out, optional] PCONTEXT *Context,
  [in, out]       PDWORD   ContextLength
);

Paramètres

[out, optional] Buffer

Pointeur vers une mémoire tampon dans laquelle initialiser une structure CONTEXT . Ce paramètre peut être NULL pour déterminer la taille de la mémoire tampon requise pour contenir un enregistrement de contexte avec le ContextFlags spécifié.

[in] ContextFlags

Valeur indiquant quelles parties de la structure Context doit être initialisée. Ce paramètre influence la taille de la structure de contexte initialisée.

[out, optional] Context

Pointeur vers une variable qui reçoit l’adresse de la structure CONTEXT initialisée dans latampon .

[in, out] ContextLength

Lors de l’entrée, spécifie la longueur de la mémoire tampon pointée par tampon, en octets. Si la mémoire tampon n’est pas suffisamment grande pour contenir les parties spécifiées de l'CONTEXT, la fonction échoue, GetLastError retourne ERROR_INSUFFICIENT_BUFFERet ContextLength est défini sur la taille requise de la mémoire tampon. Si la fonction échoue avec une erreur autre que ERROR_INSUFFICIENT_BUFFER, le contenu de ContextLength n’est pas défini.

Valeur de retour

Cette fonction retourne TRUE si elle réussit, sinon FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

InitializeContext pouvez être utilisé pour initialiser une structure CONTEXT dans une mémoire tampon avec les caractéristiques d’alignement et de taille requises. Cette routine est requise si le CONTEXT_XSTATEContextFlag est spécifié, car la taille et l’alignement du contexte requis peuvent changer en fonction des fonctionnalités du processeur activées sur le système.

Tout d’abord, appelez cette fonction avec le paramètre ContextFlags défini sur le nombre maximal de fonctionnalités que vous utiliserez et le paramètre de mémoire tampon pour NULL. La fonction retourne la taille de mémoire tampon requise en octets dans le paramètre ContextLength. Allouez suffisamment d’espace pour les données dans le de mémoire tampon et appelez à nouveau la fonction pour initialiser lede contexte . Une fois cette routine terminée, le ContextFlags membre de la structure Context est initialisé, mais le contenu restant de la structure n’est pas défini. Certains bits spécifiés dans le paramètre ContextFlags peuvent ne pas être définis dans de contexte ->ContextFlags s’ils ne sont pas pris en charge par le système. Les applications peuvent par la suite supprimer, mais ne doivent jamais ajouter de bits du ContextFlags membre de CONTEXT.

Windows 7 avec SP1 et Windows Server 2008 R2 avec SP1 : l'l’API AVX est implémentée pour la première fois 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 eux à l’aide de GetModuleHandle sur «Kernel32.dll», suivi d’appels à GetProcAddress. Pour plus d’informations, consultez Utilisation du contexte XState.

Exigences

Voir aussi

CONTEXT

CopyContext

Intel AVX

utilisation de l' de contexte XState