EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD Rückruffunktion (netdevice.h)

Artikel
02/07/2025

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

Syntax

EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD EvtNetDevicePreviewPowerOffload;

NTSTATUS EvtNetDevicePreviewPowerOffload(
  [_In_] WDFDEVICE Device,
  [_In_] NETPOWEROFFLOAD PowerOffload
)
{...}

Parameter

[_In_] Device

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

[_In_] PowerOffload

Ein NETPOWEROFFLOAD -Objekt, das den zu untersuchenden Offload des Low-Power-Protokolls darstellt.

Rückgabewert

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

Um das Protokoll offload abzulehnen, geben Sie STATUS_NDIS_PM_PROTOCOL_OFFLOAD_LIST_FULL zurück.

Bemerkungen

Treiber sind nicht erforderlich, um EvtNetDevicePreviewPowerOffloadzu implementieren, da NetAdapterCx bereits Protokoll-Offloads blockiert, die nicht mit den Stromabladefunktionen des Treibers kompatibel sind: NET_ADAPTER_POWER_OFFLOAD_ARP_CAPABILITIES und NET_ADAPTER_POWER_OFFLOAD_NS_CAPABILITIES. Wenn Ihre Hardware jedoch zusätzliche Einschränkungen aufweist, die in diesen Funktionsstrukturen nicht ausgedrückt werden können, können Sie EvtNetDevicePreviewPowerOffload 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, das Protokoll offload abzulehnen. Wenn beispielsweise die Anzahl der Protokoll offloads in der aktuellen Protokoll-Offloadliste für Device bereits die Anzahl der von der Hardware unterstützten Protokoll offloads erreicht oder überschritten haben, kann der Treiber dieses Protokoll offload ablehnen.

Weitere Informationen finden Sie unter Konfigurieren von Power Management.

Anforderungen

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

Freigeben über