функция обратного вызова MINIPORT_CANCEL_IDLE_NOTIFICATION (ndis.h)

  • Статья

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

Синтаксис

MINIPORT_CANCEL_IDLE_NOTIFICATION MiniportCancelIdleNotification;

void MiniportCancelIdleNotification(
  [in] NDIS_HANDLE MiniportAdapterContext
)
{...}

Параметры

[in] MiniportAdapterContext

Дескриптор контекстной области, выделенной драйвером мини-порта в функции MiniportInitializeEx . Драйвер мини-порта использует эту область контекста для хранения сведений о состоянии сетевого адаптера.

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

None

Remarks

Функция обработчика MiniportCancelIdleNotification необходима для драйверов минипорта, поддерживающих интерфейс выборочной приостановки NDIS. Дополнительные сведения о том, как драйвер регистрирует свои функции обработчика выборочной приостановки, см. в разделе Регистрация функций обработчика выборочной приостановки NDIS.

NDIS вызывает функцию обработчика MiniportIdleNotification драйвера miniport, чтобы запустить операцию выборочной приостановки NDIS на сетевом адаптере бездействия. После приостановки сетевого адаптера и его перехода в состояние с низким энергопотреблением NDIS может отменить уведомление о невыполненных простоях, если выполняется одно из следующих условий:

  • Драйвер чрезмерного протокола или фильтра выдает запрос на отправку пакета или запрос OID к драйверу минипорта.
  • Базовый адаптер сигнализирует о событии пробуждения, например о получении пакета, соответствующего шаблону пробуждения по локальной сети (WOL), или об изменении состояния подключения к мультимедиа.
NDIS отменяет уведомление о простое, вызывая MiniportCancelIdleNotification. При вызове этой функции обработчика драйвер мини-порта сначала отменяет все пакеты запросов ввода-вывода, относящиеся к шине, которые ранее могли быть выданы для уведомления о простое. Наконец, драйвер мини-порта вызывает NdisMIdleNotificationComplete , чтобы завершить уведомление о бездействии.

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

Рекомендации по реализации функции обработчика MiniportCancelIdleNotification и процедур завершения IRP см. в разделе Реализация функции обработчика MiniportCancelIdleNotification.

Требования

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

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

IoCancelIrp

MiniportIdleNotification

NdisMIdleNotificationComplete