NdisMIdleNotificationComplete-Funktion (ndis.h)

Miniport-Treiber rufen NdisMIdleNotificationComplete auf, um eine ausstehende Leerlaufbenachrichtigung für einen selektiven NDIS-Anhaltevorgang abzuschließen. NDIS beginnt den Vorgang, wenn die MiniportIdleNotification-Handlerfunktion des Treibers aufgerufen wird.

Syntax

void NdisMIdleNotificationComplete(
  [in] NDIS_HANDLE MiniportAdapterHandle
);

Parameter

[in] MiniportAdapterHandle

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

Rückgabewert

Keine

Bemerkungen

NDIS ruft die MiniportCancelIdleNotification-Handlerfunktion des Miniport-Treibers auf, um eine ausstehende Leerlaufbenachrichtigung für einen selektiven NDIS-Anhaltevorgang abzuschließen. Miniport-Treiber rufen NdisMIdleNotificationComplete auf, um NDIS zu benachrichtigen, dass die Leerlaufbenachrichtigung für den Netzwerkadapter abgeschlossen ist. NDIS übergibt dann den Adapter in einen Vollstromzustand, um den selektiven Angehaltenvorgang abzuschließen.

Bevor die Miniporttreiber NdisMIdleNotificationComplete aufrufen, müssen alle busspezifischen E/A-Anforderungspakete (IRPs) abgebrochen werden, die sie möglicherweise zuvor für die Leerlaufbenachrichtigung ausgestellt haben.

Wenn NDIS beispielsweise die MiniportIdleNotification-Funktion aufruft, gibt der USB-Miniporttreiber die busspezifische USB-Idle Request IRP (IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION) an den USB-Bustreiber aus. Wenn NDIS die MiniportCancelIdleNotification-Funktion des Treibers aufruft, bricht der Treiber die IRP ab. Wenn der USB-Bustreiber die Abschlussroutine aufruft, die dem IRP zugeordnet ist, bestätigt er, dass der IRP abgebrochen wurde und das Gerät in einen voll ausgelasteten Zustand fortgesetzt werden kann. Im Kontext der Vervollständigungsroutine ruft der Miniporttreiber NdisMIdleNotificationComplete auf. Weitere Informationen finden Sie unter Implementieren einer IRP-Abschlussroutine für USB-Leerlaufanforderungen.

Weitere Informationen dazu, wie Miniporttreiber NDIS-Benachrichtigungen zum selektiven Anhalten im Leerlauf ausführen, finden Sie unter Abschließen der NDIS-Benachrichtigung zum selektiven Anhalten im Leerlauf.

Hinweis Ein Miniporttreiber darf NdisMIdleNotificationConfirm nicht für eine zuvor abgeschlossene Leerlaufbenachrichtigung aufrufen.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.30 und höher.
Zielplattform	Universell
Header	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL

Weitere Informationen

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportCancelIdleNotification

MiniportIdleNotification

NdisMIdleNotificationConfirm