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


Функция 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. Вызывающий объект предоставляет длину буфера в параметре размера.

[in, out] Size

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

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

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

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

Замечания

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Поддерживается в NDIS 6.20 и более поздних версиях.
целевая платформа Всеобщий
заголовка ndis.h (include Ndis.h)
библиотеки Ndis.lib
IRQL <= DISPATCH_LEVEL

См. также

MiniportFilterResourceRequirements

MiniportInitializeEx

NDIS_RSS_PROCESSOR

NDIS_RSS_PROCESSOR_INFO

NdisOpenAdapterEx