Функция NdisMIdleNotificationConfirm (ndis.h)

Статья
02/07/2025

Драйверы минипорта вызывают NdisMIdleNotificationConfirm, чтобы уведомить NDIS о том, что неактивный сетевой адаптер можно безопасно приостановить и перейти в состояние низкой мощности.

Мини-порты вызывают эту функцию во время выборочной операции приостановки NDIS. NDIS начинает операцию при вызове функции обработчика драйвера MiniportIdleNotification.

Синтаксис

void NdisMIdleNotificationConfirm(
  [in] NDIS_HANDLE             MiniportAdapterHandle,
  [in] NDIS_DEVICE_POWER_STATE IdlePowerState
);

Параметры

[in] MiniportAdapterHandle

Сетевой адаптер обрабатывает, который NDIS передается в параметр MiniportAdapterHandleMiniportInitializeEx.

[in] IdlePowerState

Значение перечисления NDIS_DEVICE_POWER_STATE, указывающее наименьшее состояние питания, которое сетевой адаптер поддерживает для перехода с низкой мощностью.

Примечание для сетевых адаптеров USB этот параметр должен быть NdisDeviceStateDeD2.

Возвращаемое значение

Никакой

Замечания

Драйверы минипорта вызывают NdisMIdleNotificationConfirm после вызова функции драйвера MiniportIdleNotification. Вызывая NdisMIdleNotificationConfirm, драйвер уведомляет NDIS о том, что операция приостановки может запускаться, и сетевой адаптер можно перейти в состояние низкой мощности. В этом вызове драйвер минипорта задает параметр IdlePowerState самым низким состоянием питания, на которое устройство может перейти.

Прежде чем драйвер минипорта вызывает NdisMIdleNotificationConfirm, он должен выдавать все пакеты запросов ввода-вывода (IRPs), которые могут потребоваться для выборочной приостановки сетевого адаптера.

Например, когда NDIS вызывает функцию MiniportIdleNotification, драйвер мини-порта USB выдает пакет запросов ввода-вывода для конкретной шины (IRP) для запроса простоя USB (IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION) драйверу USB-шины. Когда драйвер USB-шины подтверждает, что сетевой адаптер может перейти в состояние низкой мощности, он вызывает подпрограмму обратного вызова, связанную с IRP. В контексте подпрограммы обратного вызова драйвер USB-минипорта вызывает NdisMIdleNotificationConfirm. Дополнительные сведения см. в разделе Реализацииподпрограммы обратного вызова IRP с использованием USB-простоя IRP.

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

Дополнительные сведения об обработке оповещений о выборочной приостановке приостановки NDIS см. в обработкеуведомления о выборочном приостановке приостановки NDIS.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.30 и более поздних версиях.
целевая платформа	Всеобщий
заголовка	ndis.h (include Ndis.h)
библиотеки	Ndis.lib
IRQL	PASSIVE_LEVEL

См. также

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete

Поделиться через