Функция 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.

Примечание Драйвер мини-порта не должен вызывать NdisMIdleNotificationConfirm для уведомления о завершении простоя.

 

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.30 и более поздних версиях.
Целевая платформа	Универсальное
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	<= DISPATCH_LEVEL

См. также раздел

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportCancelIdleNotification

MiniportIdleNotification

NdisMIdleNotificationConfirm