NdisGetProcessorInformation function

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(
  _Inout_  PNDIS_SYSTEM_PROCESSOR_INFO SystemProcessorInfo
);

Parameters

SystemProcessorInfo [in, out]

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 codeDescription
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

Version

Supported in NDIS 6.0 and 6.1. For NDIS 6.20 and later, ise NdisGetProcessorInformationEx or NdisGetRssProcessorInformation instead.

Header

Ndis.h (include Ndis.h)

IRQL

PASSIVE_LEVEL

See also

MiniportFilterResourceRequirements
NDIS_SYSTEM_PROCESSOR_INFO
NdisGetProcessorInformationEx
NdisGetRssProcessorInformation

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft