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 |