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

функция обратного вызова 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
Целевая платформа Windows
Header dot11wdi.h

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

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

NdisWdiIdleNotificationComplete