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來註冊此回呼函式的實作。 用戶端驅動程式通常會在啟動 net adapter 時呼叫 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;
}
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.25 |
| 最低 UMDF 版本 | 2.33 |
| 標頭 | netreceivescaling.h （包括 netadaptercx.h） |
| IRQL | PASSIVE_LEVEL |