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 du processeur du nœud spécifié.

Chaque élément du tableau décrit un ensemble de processeurs appartenant 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 , dans les éléments.

RequiredMaskCount

Lors d’un 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 de retour

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 le nœud spécifié n’a pas de processeurs associés à celui-ci (c’est-à-dire qu’il contient uniquement de la mémoire ou des périphériques), le RequiredMaskCount retourné est égal à 0 et aucune structure n’est écrite dans le tableau.

Spécifications

Voir aussi

GetMaximumProcessorGroupCount