EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD fonction de rappel (netdevice.h)

  • Article

Implémentez ce rappel facultatif pour rejeter les déchargements de protocole qui ne sont pas compatibles avec votre matériel.

Syntaxe

EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD EvtNetDevicePreviewPowerOffload;

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

Paramètres

[_In_] Device

Objet WDFDEVICE que le pilote client a obtenu précédemment avec un appel à WdfDeviceCreate.

[_In_] PowerOffload

Objet NETPOWEROFFLOAD qui représente le déchargement du protocole de faible puissance à examiner.

Valeur retournée

Pour accepter le déchargement du protocole, la fonction de rappel doit retourner STATUS_SUCCESS.

Pour rejeter le déchargement du protocole, retournez STATUS_NDIS_PM_PROTOCOL_OFFLOAD_LIST_FULL.

Remarques

Les pilotes ne sont pas nécessaires pour implémenter EvtNetDevicePreviewPowerOffload, car NetAdapterCx bloque déjà les déchargements de protocole qui ne sont pas compatibles avec les fonctionnalités de déchargement de l’alimentation du pilote : NET_ADAPTER_POWER_OFFLOAD_ARP_CAPABILITIES et NET_ADAPTER_POWER_OFFLOAD_NS_CAPABILITIES. Toutefois, si votre matériel présente des limitations supplémentaires qui ne peuvent pas être exprimées dans ces structures de fonctionnalités, vous pouvez fournir EvtNetDevicePreviewPowerOffload pour appliquer ces limitations supplémentaires.

Inscrivez votre implémentation de cette fonction de rappel en définissant le membre approprié du NET_DEVICE_POWER_POLICY_EVENT_CALLBACKS, puis en appelant NetDeviceInitSetPowerPolicyEventCallbacks.

Les pilotes clients appellent généralement NetDeviceInitSetPowerPolicyEventCallbacks lors de la création de l’objet d’appareil, avant d’appeler WdfDeviceCreate.

Dans ce rappel, les pilotes clients ont la possibilité de rejeter le déchargement du protocole. Par exemple, si le nombre de déchargements de protocole dans la liste de déchargement de protocole actuelle pour l’appareil a déjà atteint ou dépassé le nombre de déchargements de protocole pris en charge par le matériel, le pilote peut rejeter ce déchargement de protocole.

Pour plus d’informations, consultez Configuration de la gestion de l’alimentation.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 2004
En-tête netdevice.h (inclure netadaptercx.h)
IRQL PASSIVE_LEVEL