EVT_NET_ADAPTER_RECEIVE_SCALING_SET_HASH_SECRET_KEY Rückruffunktion (netreceivescaling.h)

  • Artikel

Die Rückruffunktion EvtNetAdapterReceiveScalingSetHashSecretKey wird vom Clienttreiber implementiert, um den Hashschlüssel für den Netzwerkschnittstellencontroller (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 in einem vorherigen Aufruf von NetAdapterCreate abgerufen hat.

[_In_] HashSecretKey

Ein Zeiger auf eine NET_ADAPTER_RECEIVE_SCALING_HASH_SECRET_KEY-Struktur , die den Hashschlüssel zum Überprüfen von Hashberechnungen enthält.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Hashschlüssel erfolgreich festgelegt wurde. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Hinweise

Registrieren Sie Ihre Implementierung dieser Rückruffunktion, indem Sie das entsprechende Element der NET_ADAPTER_RECEIVE_SCALING_CAPABILITIES-Struktur festlegen und dann NetAdapterSetReceiveScalingCapabilities aufrufen. Clienttreiber rufen in der Regel NetAdapterSetReceiveScalingCapabilities auf, wenn sie einen Netzadapter starten, bevor NetAdapterStart aufgerufen wird.

Beispiel

In diesem Rückruf programmieren NIC-Clienttreiber den bereitgestellten Hashschlüssel für ihre Hardware, um bei der Überprüfung von RSS-Hashberechnungen zu verwenden.

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
Kopfzeile netreceivescaling.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

NET_ADAPTER_RECEIVE_SCALING_HASH_SECRET_KEY

NetAdapterCx-Empfangsskalierung