EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD funzione di callback (netdevice.h)

  • Articolo

Implementare questo callback facoltativo per rifiutare gli offload del protocollo non compatibili con l'hardware.

Sintassi

EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD EvtNetDevicePreviewPowerOffload;

NTSTATUS EvtNetDevicePreviewPowerOffload(
  [_In_] WDFDEVICE Device,
  [_In_] NETPOWEROFFLOAD PowerOffload
)
{...}

Parametri

[_In_] Device

Oggetto WDFDEVICE ottenuto in precedenza dal driver client con una chiamata a WdfDeviceCreate.

[_In_] PowerOffload

Oggetto NETPOWEROFFLOAD che rappresenta l'offload del protocollo a basso consumo da esaminare.

Valore restituito

Per accettare l'offload del protocollo, la funzione di callback deve restituire STATUS_SUCCESS.

Per rifiutare l'offload del protocollo, restituire STATUS_NDIS_PM_PROTOCOL_OFFLOAD_LIST_FULL.

Commenti

I driver non sono necessari per implementare EvtNetDevicePreviewPowerOffload, perché NetAdapterCx blocca già gli offload del protocollo non compatibili con le funzionalità di offload di alimentazione del driver: NET_ADAPTER_POWER_OFFLOAD_ARP_CAPABILITIES e NET_ADAPTER_POWER_OFFLOAD_NS_CAPABILITIES. Tuttavia, se l'hardware presenta limitazioni aggiuntive che non possono essere espresse in queste strutture di funzionalità, è possibile fornire EvtNetDevicePreviewPowerOffload per applicare tali limitazioni aggiuntive.

Registrare l'implementazione di questa funzione di callback impostando il membro appropriato del NET_DEVICE_POWER_POLICY_EVENT_CALLBACKS, quindi chiamando NetDeviceInitSetPowerPolicyEventCallbacks.

I driver client in genere chiamano NetDeviceInitSetPowerPolicyEventCallbacks durante la creazione dell'oggetto dispositivo, prima di chiamare WdfDeviceCreate.

In questo callback, i driver client possono rifiutare l'offload del protocollo. Ad esempio, se il numero di offload del protocollo nell'elenco di offload del protocollo corrente per Dispositivo è già stato raggiunto o superato il numero di offload di protocollo supportati dall'hardware, il driver può rifiutare questo offload di protocollo.

Per altre informazioni, vedere Configurazione del risparmio energia.

Requisiti

Requisito Valore
Client minimo supportato Windows 10, versione 2004
Intestazione netdevice.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL