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 |