Skip to content

Latest commit

 

History

History
100 lines (76 loc) · 3.07 KB

nc-netreceivescaling-evt_net_adapter_receive_scaling_disable.md

File metadata and controls

100 lines (76 loc) · 3.07 KB
Raw
UID title description tech.root ms.date keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.lib req.dll req.irql req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library targetos f1_keywords topic_type api_type api_location api_name
NC:netreceivescaling.EVT_NET_ADAPTER_RECEIVE_SCALING_DISABLE
EVT_NET_ADAPTER_RECEIVE_SCALING_DISABLE (netreceivescaling.h)
The EVT_NET_ADAPTER_RECEIVE_SCALING_DISABLE callback function disables receive side scaling (RSS) for a network interface controller (NIC).
netvista
04/01/2022
EVT_NET_ADAPTER_RECEIVE_SCALING_DISABLE callback function
netreceivescaling.h
netadaptercx.h
Universal
1.25
PASSIVE_LEVEL
Windows
EVT_NET_ADAPTER_RECEIVE_SCALING_DISABLE
netreceivescaling/EVT_NET_ADAPTER_RECEIVE_SCALING_DISABLE
apiref
UserDefined
netreceivescaling.h
EVT_NET_ADAPTER_RECEIVE_SCALING_DISABLE

EVT_NET_ADAPTER_RECEIVE_SCALING_DISABLE callback function

-description

The EvtNetAdapterReceiveScalingDisable callback function is implemented by the client driver to disable receive side scaling (RSS) for a network interface controller (NIC).

-parameters

-param Adapter [In]

The NETADAPTER object the client driver obtained in a previous call to NetAdapterCreate.

-prototype

//Declaration

EVT_NET_ADAPTER_RECEIVE_SCALING_DISABLE EvtNetAdapterReceiveScalingDisable; 

// Definition

VOID EvtNetAdapterReceiveScalingDisable 
(
	_In_ NETADAPTER Adapter
)
{...}

typedef EVT_NET_ADAPTER_RECEIVE_SCALING_DISABLE *PFN_NET_ADAPTER_RECEIVE_SCALING_DISABLE;

-remarks

Register your implementation of this callback function by setting the appropriate member of the NET_ADAPTER_RECEIVE_SCALING_CAPABILITIES structure and then calling NetAdapterSetReceiveScalingCapabilities.Client drivers typically call NetAdapterSetReceiveScalingCapabilities when starting a net adapter, before calling NetAdapterStart.

Example

In this callback, client drivers disable RSS on the NIC.

Important

Client drivers should not clear or reset their indirection table from their EvtNetAdapterReceiveScalingDisable callback. The framework will set the driver's initial indirection table state.

VOID
MyEvtNetAdapterReceiveScalingDisable(
	_In_ NETADAPTER Adapter
)
{
	if(!MyHardwareRssSetControl(MY_RSS_MULTI_CPU_DISABLE))
	{
		WdfDeviceSetFailed(Adapter->WdfDevice, WdfDeviceFailedAttemptRestart);
	}
}

-see-also

EvtNetAdapterReceiveScalingEnable

NetAdapterCx Receive Side Scaling