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

Статья
02/26/2024

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

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

Синтаксис

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

Параметры

[in] MiniportAdapterHandle

Дескриптор сетевого адаптера, переданный NDIS в параметр MiniportAdapterHandleобъекта MiniportInitializeEx.

[in] IdlePowerState

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

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

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

None

Remarks

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

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

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

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

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

Требования

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

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

IOCTL_INTERNAL_USB_SUBMIT_IDLE_NOTIFICATION

MiniportIdleNotification

NdisMIdleNotificationComplete

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