NET_ADAPTER_RECEIVE_SCALING_CAPABILITIES_INIT function (netreceivescaling.h)

Article
02/22/2024

The NET_ADAPTER_RECEIVE_SCALING_CAPABILITIES_INIT function initializes a NET_ADAPTER_RECEIVE_SCALING_CAPABILITIES structure.

Syntax

void NET_ADAPTER_RECEIVE_SCALING_CAPABILITIES_INIT(
  [_Out_] NET_ADAPTER_RECEIVE_SCALING_CAPABILITIES                *Capabilities,
  [_In_]  SIZE_T                                                  NumberOfQueues,
  [_In_]  NET_ADAPTER_RECEIVE_SCALING_UNHASHED_TARGET_TYPE        UnhashedTargetType,
  [_In_]  NET_ADAPTER_RECEIVE_SCALING_HASH_TYPE                   HashTypes,
  [_In_]  NET_ADAPTER_RECEIVE_SCALING_PROTOCOL_TYPE               ProtocolTypes,
  [_In_]  PFN_NET_ADAPTER_RECEIVE_SCALING_ENABLE                  Enable,
  [_In_]  PFN_NET_ADAPTER_RECEIVE_SCALING_DISABLE                 Disable,
  [_In_]  PFN_NET_ADAPTER_RECEIVE_SCALING_SET_HASH_SECRET_KEY     SetHashSecretKey,
  [_In_]  PFN_NET_ADAPTER_RECEIVE_SCALING_SET_INDIRECTION_ENTRIES SetIndirectionEntries
);

Parameters

[_Out_] Capabilities

A pointer to the driver-allocated NET_ADAPTER_RECEIVE_SCALING_CAPABILITIES structure.

[_In_] NumberOfQueues

The number of hardware receive queues. This member must be a power of 2.

[_In_] UnhashedTargetType

A NET_ADAPTER_RECEIVE_SCALING_UNHASHED_TARGET_TYPE value that indicates the type of handling for unhashed frames. If this member is set to NetAdapterReceiveScalingUnhashedTargetTypeUnspecified, then UnhashedTarget is ignored.

[_In_] HashTypes

A NET_ADAPTER_RECEIVE_SCALING_HASH_TYPE value that indicates supported hash function types for calculating hash values.

[_In_] ProtocolTypes

A NET_ADAPTER_RECEIVE_SCALING_PROTOCOL_TYPE value that indicates the supported protocol types for calculating hash values.

[_In_] Enable

A pointer to the client driver's EvtNetAdapterReceiveScalingEnable event callback function.

[_In_] Disable

A pointer to the client driver's EvtNetAdapterReceiveScalingDisable event callback function.

[_In_] SetHashSecretKey

A pointer to the client driver's EvtNetAdapterReceiveScalingSetHashSecretKey event callback function.

[_In_] SetIndirectionEntries

A pointer to the client driver's EvtNetAdapterReceiveScalingSetIndirectionEntries event callback function.

Return value

None

Remarks

The NET_ADAPTER_RECEIVE_SCALING_CAPABILITIES structure is an input parameter to NetAdapterSetReceiveScalingCapabilities. The client must use NET_ADAPTER_RECEIVE_SCALING_CAPABILITIES_INIT to initialize this structure before calling NetAdapterSetReceiveScalingCapabilities.

Requirements

Requirement	Value
Header	netreceivescaling.h (include netadaptercx.h)