GetNumaProximityNodeEx, fonction (systemtopologyapi.h)

  • Article

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

Voir aussi

GetNumaProximityNode

Prise en charge de NUMA