GetNumaNodeProcessorMask2, fonction (systemtopologyapi.h)

Récupère le masque de processeur à plusieurs groupes du nœud spécifié.

Syntaxe

BOOL GetNumaNodeProcessorMask2(
  USHORT          NodeNumber,
  PGROUP_AFFINITY ProcessorMasks,
  USHORT          ProcessorMaskCount,
  PUSHORT         RequiredMaskCount
);

Paramètres

NodeNumber

Fournit le numéro de nœud de base zéro pour le nœud d’intérêt.

ProcessorMasks

Tableau de structures GROUP_AFFINITY , qui, lors d’un retour réussi, décrit le masque de processeur du nœud spécifié.

Chaque élément du tableau décrit un ensemble de processeurs qui appartiennent au nœud au sein d’un seul groupe de processeurs. Il y aura un élément dans le tableau résultant pour chaque groupe de processeurs dans lequel ce nœud a des processeurs actifs.

ProcessorMaskCount

Spécifie la taille du tableau ProcessorMasks , en éléments.

RequiredMaskCount

En cas de retour réussi, spécifie le nombre de structures d’affinité écrites dans le tableau.

Si le tableau d’entrée était trop petit, la fonction échoue avec ERROR_INSUFFICIENT_BUFFER et définit le paramètre RequiredMaskCount sur le nombre d’éléments requis.

Le nombre d’éléments requis est toujours inférieur ou égal au nombre maximal de groupes retourné par GetMaximumProcessorGroupCount.

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 zéro et les informations d’erreur étendues peuvent être récupérées en appelant GetLastError.

Si le tableau fourni est trop petit, la valeur d’erreur est ERROR_INSUFFICIENT_BUFFER et le paramètre RequiredMaskCount est défini sur le nombre d’éléments requis.

Si le NodeNumber fourni n’est pas valide (c’est-à-dire supérieur à la valeur retournée par GetNumaHighestNodeNumber), la valeur d’erreur est ERROR_INVALID_PARAMETER.

Remarques

Si aucun processeur n’est associé au nœud spécifié (c’est-à-dire qu’il contient uniquement de la mémoire ou des périphériques), l’élément RequiredMaskCount retourné est égal à 0 et aucune structure n’est écrite dans le tableau.

Configuration requise

Client minimal pris en charge	Windows 10 Build 20348
Serveur minimal pris en charge	Windows 10 Build 20348
En-tête	systemtopologyapi.h

Voir aussi

GetMaximumProcessorGroupCount