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:
[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 |
|---|---|
|
A operação foi concluída com sucesso. |
|
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 |