NdisMIdleNotificationConfirm-Funktion (ndis.h)

Miniport-Treiber rufen NdisMIdleNotificationConfirm auf, um NDIS zu benachrichtigen, dass der Leerlaufnetzwerkadapter sicher angehalten und in einen Energiesparzustand umgestellt werden kann.

Miniporttreiber rufen diese Funktion während eines selektiven NDIS-Anhaltevorgangs auf. NDIS beginnt den Vorgang, wenn er die MiniportIdleNotification Handlerfunktion des Treibers aufruft.

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 Leistungszustand angibt, den der Netzwerkadapter für einen Energiesparzustandsübergang unterstützt.

Hinweis Für USB-Netzwerkadapter muss dieser Parameter NdisDeviceStateD2sein.

 

Rückgabewert

Nichts

Bemerkungen

Miniport-Treiber rufen NdisMIdleNotificationConfirm auf, nachdem NDIS die MiniportIdleNotification- funktion des Treibers aufgerufen hat. Durch Aufrufen NdisMIdleNotificationConfirmbenachrichtigt der Treiber NDIS, dass der Anhaltevorgang gestartet werden kann, und der Netzwerkadapter kann in einen Energiesparzustand umgestellt werden. In diesem Aufruf legt der Miniporttreiber den IdlePowerState Parameter auf den niedrigsten Leistungszustand fest, zu dem das Gerät wechseln kann.

Bevor der Miniporttreiber NdisMIdleNotificationConfirmaufruft, muss er alle busspezifischen E/A-Anforderungspakete (IRPs) ausgeben, die erforderlich sein können, um den Netzwerkadapter selektiv anzuhalten.

Wenn NDIS beispielsweise die MiniportIdleNotification-Funktion aufruft, gibt der USB-Miniporttreiber das busspezifische I/O-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 wechselt, ruft er die Rückrufroutine auf, die dem IRP zugeordnet ist. Im Kontext der Rückrufroutine ruft der USB-Miniporttreiber NdisMIdleNotificationConfirmauf. Weitere Informationen finden Sie unter Implementieren einer IRP-Rückrufroutine für USB-Idle-Anforderung.

Hinweis Ein Miniporttreiber darf nicht NdisMIdleNotificationConfirm für eine zuvor abgeschlossene Leerlaufbenachrichtigung aufrufen. Der Miniporttreiber schließt die Leerlaufbenachrichtigung ab, indem NdisMIdleNotificationCompleteaufgerufen wird.

 

Weitere Informationen zum Behandeln von NDIS-Benachrichtigungen für selektives Anhalten im Leerlauf finden Sie unter Behandlung der NDIS-Benachrichtigung für selektives Anhalten.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDIS 6.30 und höher.
Zielplattform-	Universal
Header-	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL-	PASSIVE_LEVEL

Siehe auch

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete