EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE Rückruffunktion (netdevice.h)

  • Artikel

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 Aktivierungsquelle 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 müssen EvtNetDevicePreviewWakeSource nicht implementieren, da NetAdapterCx bereits Aktivierungsquellen 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 den entsprechenden Member der NET_DEVICE_POWER_POLICY_EVENT_CALLBACKS festlegen und dann NetDeviceInitSetPowerPolicyEventCallbacks aufrufen.

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

In diesem Rückruf erhalten Clienttreiber die Möglichkeit, die Aktivierungsquelle abzulehnen. Wenn beispielsweise die Anzahl der Energiefilter in der aktuellen Liste der Aktivierungsquellen 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
Header netdevice.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL