NdisMIdleNotificationConfirm-Funktion (ndis.h)

Miniport-Treiber rufen NdisMIdleNotificationConfirm auf, um NDIS zu benachrichtigen, dass der im Leerlauf befindliche Netzwerkadapter sicher angehalten und in einen Energiesparzustand überstellt werden kann.

Miniporttreiber rufen diese Funktion während eines NDIS-Vorgangs zum selektiven Anhalten auf. NDIS beginnt den Vorgang, wenn die MiniportIdleNotification-Handlerfunktion des Treibers aufgerufen wird.

Syntax

void NdisMIdleNotificationConfirm(
  [in] NDIS_HANDLE             MiniportAdapterHandle,
  [in] NDIS_DEVICE_POWER_STATE IdlePowerState
);

Parameter

[in] MiniportAdapterHandle

Das Netzwerkadapterhandle, das NDIS an den MiniportAdapterHandle-Parameter von MiniportInitializeEx übergeben hat.

[in] IdlePowerState

Ein NDIS_DEVICE_POWER_STATE Enumerationswert, der den niedrigsten Energiezustand angibt, den der Netzwerkadapter für einen Übergang mit dem Zustand mit geringer Energie unterstützt.

Hinweis Bei USB-Netzwerkadaptern muss dieser Parameter NdisDeviceStateD2 sein.

 

Rückgabewert

Keine

Bemerkungen

Miniporttreiber rufen NdisMIdleNotificationConfirm auf, nachdem NDIS die MiniportIdleNotification-Funktion des Treibers aufgerufen hat. Durch Aufrufen von NdisMIdleNotificationConfirm benachrichtigt der Treiber NDIS, dass der Angehaltene Vorgang gestartet werden kann und der Netzwerkadapter in einen Energiesparzustand überstellt werden kann. In diesem Aufruf legt der Miniporttreiber den IdlePowerState-Parameter auf den niedrigsten Leistungszustand fest, zu dem das Gerät wechseln kann.

Bevor der Miniporttreiber NdisMIdleNotificationConfirm aufruft, muss er alle busspezifischen E/A-Anforderungspakete (IRPs) ausgeben, die möglicherweise erforderlich sind, um den Netzwerkadapter selektiv anzusetzen.

Wenn NDIS beispielsweise die MiniportIdleNotification-Funktion aufruft, stellt der USB-Miniporttreiber das busspezifische E/A-Anforderungspaket (IRP) für eine USB-Leerlaufanforderung (IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION) an den USB-Bustreiber aus. Wenn der USB-Bustreiber bestätigt, dass der Netzwerkadapter in einen Energiesparzustand übergehen kann, ruft er die Rückrufroutine auf, die dem IRP zugeordnet ist. Im Kontext der Rückrufroutine ruft der USB-Miniporttreiber NdisMIdleNotificationConfirm auf. Weitere Informationen finden Sie unter Implementieren einer IRP-Rückrufroutine für USB-Leerlaufanforderungen.

Hinweis Ein Miniporttreiber darf NdisMIdleNotificationConfirm nicht für eine Benachrichtigung im Leerlauf aufrufen, die zuvor abgeschlossen wurde. Der Miniporttreiber schließt die Benachrichtigung im Leerlauf ab, indem er NdisMIdleNotificationComplete aufruft.

 

Weitere Informationen zum Behandeln von NDIS-Benachrichtigungen zum selektiven Anhalten von Leerlauf finden Sie unter Behandeln der NDIS-Benachrichtigung zum selektiven Anhalten des Leerlaufs.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.30 und höher.
Zielplattform	Universell
Header	ndis.h (einschließlich Ndis.h)
Bibliothek	Ndis.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete