Lire en anglais

Partager via


EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD fonction de rappel (netdevice.h)

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 de protocole à faible alimentation à examiner.

Valeur de retour

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é de l'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 appareil ont 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.

Exigences

Exigence Valeur
client minimum pris en charge Windows 10, version 2004
version minimale de UMDF 2.33
d’en-tête netdevice.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL