EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE Rückruffunktion (netdevice.h)

Artikel
02/07/2025

Implementieren Sie diesen optionalen Rückruf, um Reaktivierungsmuster 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 WdfDeviceCreateabgerufen hat.

[_In_] WakeSource

Ein NETWAKESOURCE-Objekt, das die zu untersuchende Wake-Quelle 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.

Bemerkungen

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

Registrieren Sie die Implementierung dieser Rückruffunktion, indem Sie das entsprechende Mitglied der NET_DEVICE_POWER_POLICY_EVENT_CALLBACKSfestlegen und dann NetDeviceInitSetPowerPolicyEventCallbacksaufrufen.

Clienttreiber rufen in der Regel NetDeviceInitSetPowerPolicyEventCallbacks beim Erstellen des Geräteobjekts auf, bevor sie WdfDeviceCreateaufrufen.

In diesem Rückruf erhalten Clienttreiber die Möglichkeit, die Wake-Quelle abzulehnen. Wenn beispielsweise die Anzahl der Leistungsfilter in der aktuellen Wake Source-Liste für Device die Anzahl der von der Hardware unterstützten Leistungsfilter bereits erreicht oder überschritten haben, kann der Treiber diese Wake-Quelle ablehnen.

Weitere Informationen finden Sie unter Konfigurieren von Power Management.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 2004
Zielplattform-	Universal
Mindest-UMDF-Version	2.33
Header-	netdevice.h (include netadaptercx.h)
IRQL-	PASSIVE_LEVEL

Freigeben über