Поделиться через


Функция GetNumaProximityNode (winbase.h)

Извлекает номер узла NUMA, соответствующий указанному идентификатору домена близкого взаимодействия.

Используйте функцию GetNumaProximityNodeEx , чтобы получить номер узла в качестве значения USHORT .

Синтаксис

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

Параметры

[in] ProximityId

Идентификатор домена близкого взаимодействия узла.

[out] NodeNumber

Номер узла. Если процессор не существует, этот параметр 0xFF.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Идентификатор домена близкого взаимодействия — это индекс узла NUMA в системе NUMA. Идентификаторы доменов близкого взаимодействия находятся в таблице соответствия системных ресурсов ACPI (SRAT), где они используются для связывания процессоров и областей памяти с определенным узлом NUMA. Идентификаторы домена близкого взаимодействия также находятся в пространстве имен ACPI, где они используются для связывания устройства с определенным узлом NUMA. Идентификаторы домена близкого взаимодействия обычно используются только приложениями управления, предоставляемыми производителями систем. Windows не использует идентификаторы домена близкого взаимодействия для идентификации узлов NUMA; Вместо этого он назначает уникальный номер каждому узлу NUMA в системе.

Относительное расстояние между узлами в системе хранится в таблице сведений о расстоянии локальности системы ACPI (SLIT), которая не предоставляется никакими функциями Windows. Дополнительные сведения о таблицах ACPI см. в спецификациях ACPI.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header winbase.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

GetNumaProcessorNode

GetNumaProximityNodeEx

Поддержка NUMA