GetNumaProximityNodeEx, fonction (systemtopologyapi.h)
Récupère le numéro de nœud NUMA qui correspond à l’identificateur de proximité spécifié en tant que valeur USHORT .
Syntaxe
BOOL GetNumaProximityNodeEx(
[in] ULONG ProximityId,
[out] PUSHORT NodeNumber
);
Paramètres
[in] ProximityId
Identificateur de proximité du nœud.
[out] NodeNumber
Pointe vers une variable pour recevoir le numéro de nœud de l’identificateur de proximité spécifié.
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.
Remarques
Un identificateur de domaine de proximité est un index d’un nœud NUMA sur un système NUMA. Les identificateurs de domaine de proximité se trouvent dans la table SRAT (System Resource Affinity Table) ACPI, où ils sont utilisés pour associer des processeurs et des régions de mémoire à un nœud NUMA particulier. Les identificateurs de domaine de proximité se trouvent également dans l’espace de noms ACPI, où ils sont utilisés pour associer un appareil à un nœud NUMA particulier. Les identificateurs de domaine de proximité sont généralement utilisés uniquement par les applications de gestion fournies par les fabricants de systèmes. Windows n’utilise pas d’identificateurs de domaine de proximité pour identifier les nœuds NUMA ; au lieu de cela, il affecte un nombre unique à chaque nœud NUMA dans le système.
La distance relative entre les nœuds d’un système est stockée dans la table SLIT (Locality Distance Information Table) du système ACPI, qui n’est exposée par aucune fonction Windows. Pour plus d’informations sur les tables ACPI, consultez les spécifications ACPI.
La seule différence entre la fonction GetNumaProximityNodeEx et la fonction GetNumaProximityNode est le type de données du paramètre NodeNumber .
Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT >= 0x0601. Pour plus d’informations, consultez Utilisation des en-têtes Windows.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | systemtopologyapi.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |