EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD Rückruffunktion (netdevice.h)

Artikel
05/23/2024

Implementieren Sie diesen optionalen Rückruf, um Protokollauslagerungen 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 WdfDeviceCreate abgerufen hat.

[_In_] PowerOffload

Ein NETPOWEROFFLOAD-Objekt, das die zu untersuchende Protokollabladung mit geringer Leistung darstellt.

Rückgabewert

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

Um die Protokollauslagerung abzulehnen, geben Sie STATUS_NDIS_PM_PROTOCOL_OFFLOAD_LIST_FULL zurück.

Hinweise

Treiber müssen EvtNetDevicePreviewPowerOffload nicht implementieren, da NetAdapterCx bereits Protokollauslagerungen blockiert, die nicht mit den Auslagerungsfunktionen 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 nicht in diesen Funktionsstrukturen ausgedrückt werden können, können Sie EvtNetDevicePreviewPowerOffload 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 Protokollauslagerung abzulehnen. Wenn z. B. die Anzahl der Protokollauslagerungen in der aktuellen Protokollauslagerungsliste für Gerät die Von der Hardware unterstützte Protokollauslagerung bereits erreicht oder überschritten hat, kann der Treiber diese Protokollauslagerung ablehnen.

Weitere Informationen finden Sie unter Konfigurieren der Energieverwaltung.

Anforderungen

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

Freigeben über