EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD funzione di callback (netdevice.h)

Implementare questo callback facoltativo per rifiutare i carichi di 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 bassa potenza 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, poiché NetAdapterCx blocca già i carichi di offload del protocollo che non sono compatibili con le funzionalità di offload 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 della NET_DEVICE_POWER_POLICY_EVENT_CALLBACKS, quindi chiamando NetDeviceInitSetPowerPolicyEventCallbacks.

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

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

Per altre informazioni, vedere Configurazione di Power Management.

Requisiti

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