Función NdisGetRssProcessorInformation (ndis.h)

La función NdisGetRssProcessorInformation recupera información sobre el conjunto de procesadores que un controlador de miniporte debe usar para el escalado lateral de recepción (RSS).

Sintaxis

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

Parámetros

[in] NdisHandle

Identificador de instancia de NDIS que se obtuvo durante la inicialización del autor de la llamada. Los controladores NDIS pueden usar los identificadores de las siguientes funciones:

MiniportInitializeEx

NdisOpenAdapterEx

[out, optional] RssProcessorInfo

Puntero a un búfer asignado por el autor de la llamada donde NDIS coloca la estructura de NDIS_RSS_PROCESSOR_INFO y una matriz de estructuras de NDIS_RSS_PROCESSOR que contienen información sobre el conjunto de procesadores RSS. El autor de la llamada proporciona la longitud del búfer en el parámetro Size .

[in, out] Size

Puntero a un valor que es el tamaño, en bytes, del búfer proporcionado por el autor de la llamada. Cuando la función devuelve, este miembro contiene la cantidad de datos que NDIS puso en el búfer o el tamaño necesario del búfer si el búfer era demasiado corto.

Valor devuelto

NdisGetRssProcessorInformation puede devolver uno de los siguientes valores de estado:

Código devuelto Descripción
NDIS_STATUS_SUCCESS
La operación se ha completado correctamente.
NDIS_STATUS_BUFFER_TOO_SHORT
El tamaño especificado en el parámetro Size era demasiado pequeño. En este caso, NDIS proporciona el tamaño de búfer necesario en el parámetro Size .

Comentarios

Los controladores NDIS llaman a la función NdisGetRssProcessorInformation para recuperar información sobre los procesadores de escalado lateral de recepción (RSS) en el equipo local.

Controladores de minipuerto compatibles con RSS que admiten llamadas MSI-X a NdisGetRssProcessorInformation en sus Función MiniportFilterResourceRequirements . Los controladores de miniport establecen la afinidad de interrupción de los mensajes MSI-X asignados a los procesadores RSS especificados en el miembro RssProcessors del parámetro RssProcessorInfo .

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con NDIS 6.20 y versiones posteriores.
Plataforma de destino Universal
Encabezado ndis.h (incluya Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL

Consulte también

MiniportFilterResourceRequirements

MiniportInitializeEx

NDIS_RSS_PROCESSOR

NDIS_RSS_PROCESSOR_INFO

NdisOpenAdapterEx