GetNumaProximityNode, fonction (winbase.h)

Récupère le numéro de nœud NUMA qui correspond à l’identificateur de domaine de proximité spécifié.

Utilisez la fonction GetNumaProximityNodeEx pour récupérer le numéro de nœud en tant que valeur USHORT .

Syntaxe

BOOL GetNumaProximityNode(
  [in]  ULONG  ProximityId,
  [out] PUCHAR NodeNumber
);

Paramètres

[in] ProximityId

Identificateur de domaine de proximité du nœud.

[out] NodeNumber

Numéro de nœud. Si le processeur n’existe pas, ce paramètre est 0xFF.

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

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.

Configuration requise

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

Voir aussi

GetNumaProcessorNode

GetNumaProximityNodeEx

Prise en charge de NUMA