EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE fonction de rappel (netdevice.h)

Article
05/23/2024

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 précédemment obtenu avec un appel à WdfDeviceCreate.

[_In_] WakeSource

Objet NETWAKESOURCE qui représente la source de sortie de veille à examiner.

Valeur retournée

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 obligés d’implémenter EvtNetDevicePreviewWakeSource, car NetAdapterCx bloque déjà les sources d’éveil qui ne sont pas compatibles avec les NET_ADAPTER_WAKE_BITMAP_CAPABILITIES du 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é 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 la source de sortie de veille. Par exemple, si le nombre de filtres d’alimentation dans la liste actuelle des sources de sortie de veille pour l’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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 2004
Plateforme cible	Universal
Version UMDF minimale	2,33
En-tête	netdevice.h (inclure netadaptercx.h)
IRQL	PASSIVE_LEVEL

Partager via