Freigeben über

EVT_NET_ADAPTER_RECEIVE_SCALING_SET_HASH_SECRET_KEY Rückruffunktion (netreceivescaling.h)

  • Artikel

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

Weitere Informationen

NET_ADAPTER_RECEIVE_SCALING_HASH_SECRET_KEY

NetAdapterCx-Empfangsseitige Skalierung