SetProcessAffinityUpdateMode, fonction (processthreadsapi.h)

Définit le mode de mise à jour de l’affinité du processus spécifié.

Syntaxe

BOOL SetProcessAffinityUpdateMode(
  [in] HANDLE hProcess,
  [in] DWORD  dwFlags
);

Paramètres

[in] hProcess

Handle du processus. Ce handle doit être retourné par la fonction GetCurrentProcess .

[in] dwFlags

Mode de mise à jour de l’affinité. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
0	Désactive la mise à jour dynamique de l’affinité de processus par le système.
PROCESS_AFFINITY_ENABLE_AUTO_UPDATE 0x00000001UL	Active la mise à jour dynamique de l’affinité de processus par le système.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Le système peut ajuster l’affinité de processus dans différentes conditions, par exemple lorsqu’un processeur est ajouté dynamiquement. Par défaut, les mises à jour dynamiques de l’affinité de processus sont désactivées pour chaque processus.

Les processus doivent utiliser cette fonction pour indiquer s’ils peuvent gérer l’ajustement dynamique de l’affinité de processus par le système. Une fois qu’un processus a activé le mode de mise à jour d’affinité, il peut appeler cette fonction pour la désactiver. Toutefois, un processus ne peut pas activer le mode de mise à jour d’affinité après avoir utilisé cette fonction pour le désactiver.

Les processus enfants n’héritent pas du mode de mise à jour d’affinité du processus parent. Le mode de mise à jour de l’affinité doit être défini explicitement pour chaque processus enfant.

Pour compiler une application qui appelle cette fonction, définissez _WIN32_WINNT comme 0x0600 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista avec SP1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	processthreadsapi.h (inclure Windows.h sur Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

QueryProcessAffinityUpdateMode