NdisGetRssProcessorInformation function (ndis.h)
The NdisGetRssProcessorInformation function retrieves information about the set of processors that a miniport driver must use for receive side scaling (RSS).
Syntax
NDIS_STATUS NdisGetRssProcessorInformation(
[in] NDIS_HANDLE NdisHandle,
[out, optional] PNDIS_RSS_PROCESSOR_INFO RssProcessorInfo,
[in, out] PSIZE_T Size
);
Parameters
[in] NdisHandle
An NDIS instance handle that was obtained during caller initialization. NDIS drivers can use the handles from the following functions:
[out, optional] RssProcessorInfo
A pointer to a caller-allocated buffer where NDIS puts the NDIS_RSS_PROCESSOR_INFO structure and an array of NDIS_RSS_PROCESSOR structures that contain information about the RSS processor set. The caller provides the length of the buffer in the Size parameter.
[in, out] Size
A pointer to a value that is the size, in bytes, of the buffer that the caller provided. When the function returns, this member contains either the amount of data that NDIS put in the buffer or the required size of the buffer if the buffer was too short.
Return value
NdisGetRssProcessorInformation can return one of the following status values:
| Return code | Description |
|---|---|
|
The operation completed successfully. |
|
The size that was specified in Size parameter was too small. In this case, NDIS provides the required buffer size in the Size parameter. |
Remarks
NDIS drivers call the NdisGetRssProcessorInformation function to retrieve information about the receive side scaling (RSS) processors on the local computer.
RSS-capable miniport drivers that support MSI-X call NdisGetRssProcessorInformation 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 RssProcessorInfo parameter.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Supported in NDIS 6.20 and later. |
| Target Platform | Universal |
| Header | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |