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.
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.
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