EVT_NET_ADAPTER_RECEIVE_SCALING_SET_HASH_SECRET_KEY función de devolución de llamada (netreceivescaling.h)
El controlador de cliente implementa la función de devolución de llamada EvtNetAdapterReceiveScalingSetHashSecretKey para establecer la clave secreta hash para la controladora de interfaz de red (NIC).
Sintaxis
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
)
{...}
Parámetros
[_In_] Adapter
Objeto NETADAPTER que obtuvo el controlador de cliente en una llamada anterior a NetAdapterCreate.
[_In_] HashSecretKey
Puntero a una estructura de NET_ADAPTER_RECEIVE_SCALING_HASH_SECRET_KEY que contiene la clave secreta hash para validar los cálculos hash.
Valor devuelto
Devuelve STATUS_SUCCESS si la clave secreta hash se estableció correctamente. De lo contrario, devuelve un código de error NTSTATUS adecuado.
Comentarios
Registre la implementación de esta función de devolución de llamada estableciendo el miembro adecuado de la estructura NET_ADAPTER_RECEIVE_SCALING_CAPABILITIES y, a continuación, llamando a NetAdapterSetReceiveScalingCapabilities. Los controladores de cliente suelen llamar a NetAdapterSetReceiveScalingCapabilities al iniciar un adaptador net antes de llamar a NetAdapterStart.
Ejemplo
En esta devolución de llamada, los controladores de cliente NIC programan la clave secreta hash proporcionada a su hardware para su uso en la comprobación de cálculos hash 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;
}
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1,25 |
| Versión mínima de UMDF | 2,33 |
| Encabezado | netreceivescaling.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |