Функция GetNumaProximityNodeEx (systemtopologyapi.h)
Извлекает номер узла NUMA, соответствующий указанному идентификатору близкого взаимодействия в качестве значения USHORT .
Синтаксис
BOOL GetNumaProximityNodeEx(
[in] ULONG ProximityId,
[out] PUSHORT NodeNumber
);
Параметры
[in] ProximityId
Идентификатор близкого взаимодействия узла.
[out] NodeNumber
Указывает на переменную для получения номера узла для указанного идентификатора близкого взаимодействия.
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение.
Комментарии
Идентификатор домена близкого взаимодействия — это индекс узла NUMA в системе NUMA. Идентификаторы доменов близкого взаимодействия находятся в таблице сопоставления системных ресурсов ACPI (SRAT), где они используются для связывания процессоров и регионов памяти с определенным узлом NUMA. Идентификаторы доменов близкого взаимодействия также находятся в пространстве имен ACPI, где они используются для связывания устройства с определенным узлом NUMA. Идентификаторы доменов близкого взаимодействия обычно используются только приложениями управления, предоставляемыми производителями систем. Windows не использует идентификаторы доменов близкого взаимодействия для идентификации узлов NUMA; Вместо этого он назначает уникальный номер каждому узлу NUMA в системе.
Относительное расстояние между узлами в системе хранится в таблице сведений о расположении системы ACPI (SLIT), которая не предоставляется никакими функциями Windows. Дополнительные сведения о таблицах ACPI см. в спецификациях ACPI.
Единственное различие между функцией GetNumaProximityNodeEx и функцией GetNumaProximityNode заключается в типе данных параметра NodeNumber .
Чтобы скомпилировать приложение, использующее эту функцию, задайте _WIN32_WINNT >= 0x0601. Дополнительные сведения см. в разделе Использование заголовков Windows.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | systemtopologyapi.h (включая Windows.h) |
| Библиотека | Kernel32.lib |
| DLL | Kernel32.dll |