Функция StorPortGetNodeAffinity2 (storport.h)

Статья
02/07/2025

Минипорт может вызывать StorPortGetNodeAffinity2, чтобы получить текущее сходство процессора с несколькими группами для заданного узла NUMA.

Синтаксис

ULONG StorPortGetNodeAffinity2(
  PVOID           HwDeviceExtension,
  ULONG           NodeNumber,
  PGROUP_AFFINITY GroupAffinities,
  USHORT          GroupAffinitiesCount,
  PUSHORT         GroupAffinitiesCountRequired
);

Параметры

HwDeviceExtension

[in] Указатель на расширение устройства минипорта.

NodeNumber

[in] Номер узла для запроса.

GroupAffinities

[out] Указатель на массив структур GROUP_AFFINITY, которые при успешном выполнении получают номер группы и маску сходства определенной группы.

GroupAffinitiesCount

[in] Число элементов в массиве, на который GroupAffinities указывает. Если массив слишком мал для хранения сходства узлов, возвращается STATUS_BUFFER_TOO_SMALL, а количество необходимых элементов возвращается в GroupAffinitiesRequired.

GroupAffinitiesCountRequired

[out] Указатель на значение, которое получает количество сопоставлений групп, необходимых для представления сходства узлов.

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

StorPortGetNodeAffinity2 возвращает STOR_STATUS_SUCCESS, если сопоставление узлов было выполнено успешно. Возможные значения возвращаемых ошибок включают следующие значения.

Возвращаемый код	Описание
STOR_STATUS_INVALID_PARAMETER	Существует недопустимый параметр, например недопустимое значение NodeNumber.
STOR_STATUS_BUFFER_TOO_SMALL	Предоставленный массив слишком мал.
STOR_STATUS_UNSUCCESSFUL	Произошла ошибка по внутренним причинам.

Замечания

Дополнительные сведения см. в разделе ПримечанияKeQueryNodeActiveAffinity2.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 11, версия 22H2
заголовка	storport.h

См. также

GROUP_AFFINITY

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