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

Важный

Этот раздел является частью модели драйвера WDI , выпущенной в Windows 10. Модель драйвера WDI находится в режиме обслуживания и получит только исправления с высоким приоритетом. WiFiCx — это модель драйвера Wi-Fi, выпущенная в Windows 11. Мы рекомендуем использовать WiFiCx для использования новейших функций.

NDIS вызывает функцию обработчика MiniportWdiIdleNotification, чтобы запустить выборочную операцию приостановки NDIS на неактивном сетевом адаптере. С помощью этой операции сетевой адаптер приостанавливается и переходит в состояние низкой мощности.

Это обработчик мини-порта WDI внутри NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.

Заметка

Необходимо объявить функцию с помощью типа MINIPORT_WDI_IDLE_NOTIFICATION . Дополнительные сведения см. в следующем разделе "Примеры".

Синтаксис

MINIPORT_WDI_IDLE_NOTIFICATION MiniportWdiIdleNotification;

NDIS_STATUS MiniportWdiIdleNotification(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] BOOLEAN ForceIdle
)
{...}

Параметры

[in] MiniportAdapterContext

Дескриптор области контекста, выделенной драйвером мини-порта.

[in] ForceIdle

Значение BOOLEAN, которое, если задано значение TRUE, указывает, что минипорт-драйвер не должен ветоировать уведомление об простое и продолжать переход с низким уровнем питания.

Дополнительные сведения о параметре ForceIdle см. в разделе "Примечания".

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

MiniportWdiIdleNotification может возвращать любое из следующих возвращаемых значений.

Возвращаемый код	Описание
NDIS_STATUS_PENDING	Минипорт-драйвер успешно обработал уведомление об простое. Уведомление остается в состоянии ожидания, пока драйвер минипорта не вызывает NdisWdiIdleNotificationComplete.  Заметка: Драйвер минипорта не должен возвращать NDIS_STATUS_SUCCESS из MiniportWdiIdleNotification.
NDIS_STATUS_BUSY	Минипорт-драйвер ветоировал уведомление об простое, так как сетевой адаптер по-прежнему используется. Заметка: MiniportWdiIdleNotification не должен возвращать этот код состояния, если параметр ForceIdle имеет значение TRUE.
NDIS_STATUS_FAILURE	Минипорт-водитель не смог успешно выдать IRP для конкретной шины.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows 10
Минимальный поддерживаемый сервер	Windows Server 2016
Целевая платформа	Виндоус
Заголовок	dot11wdi.h

См. также

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

NdisWdiIdleNotificationComplete