Função NdisGetRssProcessorInformation (ndis.h)

A função NdisGetRssProcessorInformation recupera informações sobre o conjunto de processadores que um driver de miniporto deve usar para o RSS (dimensionamento lateral de recebimento).

Sintaxe

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

Parâmetros

[in] NdisHandle

Um identificador de instância do NDIS que foi obtido durante a inicialização do chamador. Os drivers NDIS podem usar os identificadores das seguintes funções:

MiniportInitializeEx

NdisOpenAdapterEx

[out, optional] RssProcessorInfo

Um ponteiro para um buffer alocado pelo chamador em que o NDIS coloca a estrutura NDIS_RSS_PROCESSOR_INFO e uma matriz de estruturas NDIS_RSS_PROCESSOR que contêm informações sobre o conjunto de processadores RSS. O chamador fornece o comprimento do buffer no parâmetro Size .

[in, out] Size

Um ponteiro para um valor que é o tamanho, em bytes, do buffer fornecido pelo chamador. Quando a função retorna, esse membro contém a quantidade de dados que o NDIS colocou no buffer ou o tamanho necessário do buffer se o buffer for muito curto.

Retornar valor

NdisGetRssProcessorInformation pode retornar um dos seguintes valores de status:

Código de retorno	Descrição
NDIS_STATUS_SUCCESS	A operação foi concluída com sucesso.
NDIS_STATUS_BUFFER_TOO_SHORT	O tamanho especificado no parâmetro Size era muito pequeno. Nesse caso, o NDIS fornece o tamanho do buffer necessário no parâmetro Size .

Comentários

Os drivers NDIS chamam a função NdisGetRssProcessorInformation para recuperar informações sobre os processadores RSS (receive side scaling) no computador local.

Drivers de miniporta compatíveis com RSS que dão suporte à chamada MSI-X NdisGetRssProcessorInformation em seus Função MiniportFilterResourceRequirements . Os drivers de miniporto definem a afinidade de interrupção das mensagens MSI-X alocadas para os processadores RSS especificados no membro RssProcessors do parâmetro RssProcessorInfo .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte no NDIS 6.20 e posterior.
Plataforma de Destino	Universal
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	<= DISPATCH_LEVEL

Confira também

MiniportFilterResourceRequirements

MiniportInitializeEx

NDIS_RSS_PROCESSOR

NDIS_RSS_PROCESSOR_INFO

NdisOpenAdapterEx