EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD funzione di callback (netdevice.h)

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