функция обратного вызова 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 |