NdisGetProcessorInformation function (ndis.h)

The NdisGetProcessorInformation function retrieves information about the CPU topology of the local computer and the set of processors that a miniport driver must use for receive side scaling (RSS).

Syntax

NDIS_STATUS NdisGetProcessorInformation(
  [in, out] PNDIS_SYSTEM_PROCESSOR_INFO SystemProcessorInfo
);

Parameters

[in, out] SystemProcessorInfo

A pointer to an NDIS_SYSTEM_PROCESSOR_INFO structure that NDIS fills with the information about the CPU topology of the system and the RSS processor set.

Return value

NdisGetProcessorInformation can return one of the following status values:

Return code Description
NDIS_STATUS_SUCCESS
The operation completed successfully.
NDIS_STATUS_BUFFER_TOO_SHORT
The size that was specified in the Header.Size member of the SystemProcessorInfo parameter was too small.

Remarks

NDIS drivers call the NdisGetProcessorInformation function to retrieve information about the processors on the local computer.

RSS-capable miniport drivers that support MSI-X call NdisGetProcessorInformation in their MiniportFilterResourceRequirements function. Miniport drivers set the interrupt affinity of the allocated MSI-X messages to the RSS processors that are specified in the RssProcessors member of the SystemProcessorInfo parameter.

Requirements

Requirement Value
Minimum supported client Supported in NDIS 6.0 and 6.1. For NDIS 6.20 and later, ise NdisGetProcessorInformationEx or NdisGetRssProcessorInformation instead.
Target Platform Universal
Header ndis.h (include Ndis.h)
Library Ndis.lib
IRQL PASSIVE_LEVEL

See also

MiniportFilterResourceRequirements

NDIS_SYSTEM_PROCESSOR_INFO

NdisGetProcessorInformationEx NdisGetRssProcessorInformation