共用方式為

EVT_NET_ADAPTER_RECEIVE_SCALING_SET_HASH_SECRET_KEY回呼函式 (netreceivescaling.h)

  • 發行項

EvtNetAdapterReceiveScalingSetHashSecretKey 回呼函式是由用戶端驅動程序實作，以設定網路介面控制器的哈希秘密密鑰 (NIC) 。

語法

EVT_NET_ADAPTER_RECEIVE_SCALING_SET_HASH_SECRET_KEY EvtNetAdapterReceiveScalingSetHashSecretKey;

NTSTATUS EvtNetAdapterReceiveScalingSetHashSecretKey(
  [_In_] NETADAPTER Adapter,
  [_In_] const NET_ADAPTER_RECEIVE_SCALING_HASH_SECRET_KEY *HashSecretKey
)
{...}

參數

[_In_] Adapter

在先前呼叫 NetAdapterCreate 中取得之客戶端驅動程式的 NETADAPTER 物件。

[_In_] HashSecretKey

NET_ADAPTER_RECEIVE_SCALING_HASH_SECRET_KEY 結構的指標 ，其中包含用來驗證哈希計算的哈希秘密密鑰。

傳回值

如果成功設定哈希秘密密鑰，則傳回STATUS_SUCCESS。 否則，傳回適當的NTSTATUS錯誤碼。

備註

藉由設定 NET_ADAPTER_RECEIVE_SCALING_CAPABILITIES 結構的適當成員，然後呼叫 NetAdapterSetReceiveScalingCapabilities 來註冊此回呼函式的實作。 用戶端驅動程式通常會在啟動網路適配器之前呼叫 NetAdapterSetReceiveScalingCapabilities ，然後再呼叫 NetAdapterStart。

範例

在此回呼中，NIC 用戶端驅動程式會將提供的哈希秘密密鑰程式設計給其硬體，以用於驗證 RSS 哈希計算。

NTSTATUS
MyEvtNetAdapterReceiveScalingSetHashSecretKey(
	_In_	NETADAPTER 											Adapter,
	_In_	const NET_ADAPTER_RECEIVE_SCALING_HASH_SECRET_KEY *	HashSecretKey	
)
{
	const UINT32* key = (const UINT32*)HashSecretKey->Key;
	if(!MyHardwareRssSetHashSecretKey)
	{
		WdfDeviceSetFailed(Adapter->WdfDevice, WdfDeviceFailedAttemptRestart);
		return STATUS_UNSUCCESSFUL;
	}

	return STATUS_SUCCESS;
}

規格需求

需求 值
目標平台 Universal
最小 KMDF 版本 1.25
最低UMDF版本 2.33
標頭 netreceivescaling.h (包含 netadaptercx.h)
IRQL PASSIVE_LEVEL

另請參閱

NET_ADAPTER_RECEIVE_SCALING_HASH_SECRET_KEY

NetAdapterCx 接收端調整