EVT_NET_ADAPTER_RECEIVE_SCALING_SET_HASH_SECRET_KEY Rückruffunktion (netreceivescaling.h)
Die Rückruffunktion EvtNetAdapterReceiveScalingSetHashSecretKey wird vom Clienttreiber implementiert, um den geheimen Hashschlüssel für den Netzwerkschnittstellencontroller (Network Interface Controller, NIC) festzulegen.
Syntax
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
)
{...}
Parameter
[_In_] Adapter
Das NETADAPTER-Objekt, das der Clienttreiber bei einem vorherigen Aufruf von NetAdapterCreate abgerufen hat.
[_In_] HashSecretKey
Ein Zeiger auf eine NET_ADAPTER_RECEIVE_SCALING_HASH_SECRET_KEY-Struktur , die den geheimen Hashschlüssel zum Überprüfen von Hashberechnungen enthält.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der geheime Hashschlüssel erfolgreich festgelegt wurde. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.
Hinweise
Registrieren Sie Ihre Implementierung dieser Rückruffunktion, indem Sie den entsprechenden Member der NET_ADAPTER_RECEIVE_SCALING_CAPABILITIES-Struktur festlegen und dann NetAdapterSetReceiveScalingCapabilities aufrufen. Clienttreiber rufen in der Regel NetAdapterSetReceiveScalingCapabilities beim Starten eines Netzadapters auf, bevor NetAdapterStart aufgerufen wird.
Beispiel
In diesem Rückruf programmieren NIC-Clienttreiber den bereitgestellten geheimen Hashschlüssel auf ihrer Hardware, um RSS-Hashberechnungen zu überprüfen.
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;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1,25 |
| UMDF-Mindestversion | 2.33 |
| Kopfzeile | netreceivescaling.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |