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