EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE Rückruffunktion (netdevice.h)

Artikel
05/23/2024

Implementieren Sie diesen optionalen Rückruf, um Aktivierungsmuster abzulehnen, die nicht mit Ihrer Hardware kompatibel sind.

Syntax

EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE EvtNetDevicePreviewWakeSource;

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

Parameter

[_In_] Device

Das WDFDEVICE-Objekt, das der Clienttreiber zuvor mit einem Aufruf von WdfDeviceCreate abgerufen hat.

[_In_] WakeSource

Ein NETWAKESOURCE-Objekt, das die zu untersuchende Reaktivierungsquelle darstellt.

Rückgabewert

Um das Muster zu akzeptieren, muss die Rückruffunktion STATUS_SUCCESS zurückgeben.

Um das Muster abzulehnen, geben Sie STATUS_NDIS_PM_WOL_PATTERN_LIST_FULL zurück.

Hinweise

Treiber sind nicht erforderlich, um EvtNetDevicePreviewWakeSource zu implementieren, da NetAdapterCx bereits Wake-Quellen blockiert, die nicht mit dem NET_ADAPTER_WAKE_BITMAP_CAPABILITIES des Treibers kompatibel sind. Wenn Ihre Hardware jedoch zusätzliche Einschränkungen aufweist, die nicht in der Bitmapfunktionsstruktur ausgedrückt werden können, können Sie EvtNetDevicePreviewWakeSource bereitstellen, um diese zusätzlichen Einschränkungen zu erzwingen.

Registrieren Sie Ihre Implementierung dieser Rückruffunktion, indem Sie das entsprechende Element der NET_DEVICE_POWER_POLICY_EVENT_CALLBACKS festlegen und dann NetDeviceInitSetPowerPolicyEventCallbacks aufrufen.

Clienttreiber rufen normalerweise NetDeviceInitSetPowerPolicyEventCallbacks beim Erstellen des Geräteobjekts auf, bevor WdfDeviceCreate aufgerufen wird.

In diesem Rückruf erhalten Clienttreiber die Möglichkeit, die Reaktivierungsquelle abzulehnen. Wenn beispielsweise die Anzahl der Energiefilter in der aktuellen Quellliste für "Gerät " die Anzahl der von der Hardware unterstützten Energiefilter bereits erreicht oder überschritten hat, kann der Treiber diese Aktivierungsquelle ablehnen.

Weitere Informationen finden Sie unter Konfigurieren der Energieverwaltung.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 2004
Zielplattform	Universell
UMDF-Mindestversion	2.33
Kopfzeile	netdevice.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL

Freigeben über