Функция NdisMIdleNotificationComplete (ndis.h)
Драйверы минипорта вызывают NdisMIdleNotificationComplete , чтобы завершить уведомление об ожидающих простоях для операции выборочной приостановки NDIS. NDIS начинает операцию при вызове функции обработчика MiniportIdleNotification драйвера.
Синтаксис
void NdisMIdleNotificationComplete(
[in] NDIS_HANDLE MiniportAdapterHandle
);
Параметры
[in] MiniportAdapterHandle
Дескриптор сетевого адаптера, переданный NDIS в параметр MiniportAdapterHandleобъекта MiniportInitializeEx.
Возвращаемое значение
None
Remarks
NDIS вызывает функцию обработчика MiniportCancelIdleNotification драйвера минипорта для завершения ожидающего уведомления о простое для операции выборочной приостановки NDIS. Драйверы минипорта вызывают NdisMIdleNotificationComplete , чтобы уведомить NDIS о том, что уведомление о бездействии для сетевого адаптера завершено. Затем NDIS переводит адаптер в состояние полного питания, чтобы завершить операцию выборочной приостановки.
Прежде чем водители минипорта вызовет NdisMIdleNotificationComplete, он должен отменить все пакеты запросов ввода-вывода, относящиеся к шине, которые ранее были выданы для уведомления о простое.
Например, когда NDIS вызывает функцию MiniportIdleNotification , драйвер минипорта USB выдает драйверу USB-шины IRP-запрос бездействия USB (IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION). Когда NDIS вызывает функцию MiniportCancelIdleNotification драйвера, драйвер отменяет IRP. Когда драйвер USB-шины вызывает подпрограмму завершения, связанную с IRP, он подтверждает, что IRP отменена и устройство может вернуться в состояние полного питания. В контексте процедуры завершения драйвер минипорта вызывает NdisMIdleNotificationComplete. Дополнительные сведения см. в разделе Реализация процедуры завершения IRP бездействующих запросов USB.
Дополнительные сведения о том, как драйверы минипорта заполняют уведомления о выборочной приостановке простоя NDIS, см. в разделе Завершение уведомления о выборочной приостановке простоя NDIS.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Поддерживается в NDIS 6.30 и более поздних версиях. |
| Целевая платформа | Универсальное |
| Верхняя часть | ndis.h (включая Ndis.h) |
| Библиотека | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
См. также раздел
IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION