Функция NdisGetRssProcessorInformation (ndis.h)

  • Статья

Функция NdisGetRssProcessorInformation извлекает сведения о наборе процессоров, которые драйвер мини-порта должен использовать для масштабирования на стороне приема (RSS).

Синтаксис

NDIS_STATUS NdisGetRssProcessorInformation(
  [in]            NDIS_HANDLE              NdisHandle,
  [out, optional] PNDIS_RSS_PROCESSOR_INFO RssProcessorInfo,
  [in, out]       PSIZE_T                  Size
);

Параметры

[in] NdisHandle

Дескриптор экземпляра NDIS, полученный во время инициализации вызывающего объекта. Драйверы NDIS могут использовать дескрипторы из следующих функций:

MiniportInitializeEx

NdisOpenAdapterEx

[out, optional] RssProcessorInfo

Указатель на буфер, выделенный вызывающим объектом, где NDIS помещает NDIS_RSS_PROCESSOR_INFO структуру и массив NDIS_RSS_PROCESSOR структур, содержащих сведения о наборе процессоров RSS. Вызывающий объект предоставляет длину буфера в параметре Size .

[in, out] Size

Указатель на значение, представляющее размер (в байтах) буфера, предоставленного вызывающим объектом. При возврате функции этот элемент содержит либо объем данных, которые NDIS помещает в буфер, либо требуемый размер буфера, если буфер был слишком коротким.

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

NdisGetRssProcessorInformation может возвращать одно из следующих значений состояния:

Код возврата Описание
NDIS_STATUS_SUCCESS
 Операция выполнена успешно.
NDIS_STATUS_BUFFER_TOO_SHORT
 Размер, указанный в параметре Size , был слишком мал. В этом случае NDIS предоставляет требуемый размер буфера в параметре Size .

Комментарии

Драйверы NDIS вызывают функцию NdisGetRssProcessorInformation для получения сведений о процессорах масштабирования на стороне приема (RSS) на локальном компьютере.

Драйверы мини-портов с поддержкой RSS, поддерживающие MSI-X, вызывают NdisGetRssProcessorInformation в своих Функция MiniportFilterResourceRequirements . Драйверы miniport устанавливают сходство прерываний выделенных сообщений MSI-X с процессорами RSS, указанными в элементе RssProcessors параметра RssProcessorInfo .

Требования

Требование Значение
Минимальная версия клиента Поддерживается в NDIS 6.20 и более поздних версиях.
Целевая платформа Универсальное
Верхняя часть ndis.h (включая Ndis.h)
Библиотека Ndis.lib
IRQL <= DISPATCH_LEVEL

См. также раздел

MiniportFilterResourceRequirements

MiniportInitializeEx

NDIS_RSS_PROCESSOR

NDIS_RSS_PROCESSOR_INFO

NdisOpenAdapterEx