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 |
| 最小 UMDF バージョン | 2.33 |
| Header | netreceivescaling.h (netadaptercx.h を含む) |
| IRQL | PASSIVE_LEVEL |