EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE fonction de rappel (netdevice.h)

Article
02/07/2025

Implémentez ce rappel facultatif pour rejeter les modèles de veille qui ne sont pas compatibles avec votre matériel.

Syntaxe

EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE EvtNetDevicePreviewWakeSource;

NTSTATUS EvtNetDevicePreviewWakeSource(
  [_In_] WDFDEVICE Device,
  [_In_] NETWAKESOURCE WakeSource
)
{...}

Paramètres

[_In_] Device

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

[_In_] WakeSource

Objet NETWAKESOURCE qui représente la source de mise en éveil à examiner.

Valeur de retour

Pour accepter le modèle, la fonction de rappel doit retourner STATUS_SUCCESS.

Pour rejeter le modèle, retournez STATUS_NDIS_PM_WOL_PATTERN_LIST_FULL.

Remarques

Les pilotes ne sont pas nécessaires pour implémenter EvtNetDevicePreviewWakeSource, car NetAdapterCx bloque déjà les sources de mise en éveil qui ne sont pas compatibles avec le NET_ADAPTER_WAKE_BITMAP_CAPABILITIESdu pilote. Toutefois, si votre matériel présente des limitations supplémentaires qui ne peuvent pas être exprimées dans la structure des fonctionnalités bitmap, vous pouvez fournir EvtNetDevicePreviewWakeSource 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 la source de mise en éveil. Par exemple, si le nombre de filtres d’alimentation dans la liste de sources de mise en éveil actuelle pour appareil a déjà atteint ou dépassé le nombre de filtres d’alimentation pris en charge par le matériel, le pilote peut rejeter cette source de sortie de veille.

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

Exigences

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

Partager via