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 を呼び出します。 クライアント ドライバーは通常、NetAdapterStart を呼び出す前に、Net アダプターの起動時に NetAdapterSetReceiveScalingCapabilities を呼び出 します。

例

このコールバックでは、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
Header	netreceivescaling.h (netadaptercx.h を含む)
IRQL	PASSIVE_LEVEL

こちらもご覧ください

NET_ADAPTER_RECEIVE_SCALING_HASH_SECRET_KEY

NetAdapterCx Receive Side Scaling