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

Статья
02/07/2025

Драйвер фильтра может вызывать функцию NdisFNetPnPEvent для пересылки сетевого события Plug and Play (PnP) или power Management в переопределяющие драйверы.

Синтаксис

NDIS_STATUS NdisFNetPnPEvent(
  NDIS_HANDLE                 NdisFilterHandle,
  PNET_PNP_EVENT_NOTIFICATION NetPnPEventNotification
);

Параметры

NdisFilterHandle

Дескриптор области контекста для модуля фильтра. Драйвер фильтра создал и инициализировал эту область контекста в функции FilterAttach.

NetPnPEventNotification

Указатель на NET_PNP_EVENT_NOTIFICATION структура, описывающая событие PnP сети или событие Power Management, перенаправленное драйвером фильтра.

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

NdisFNetPnPEvent может вернуть одно из следующих элементов:

Возвращаемый код	Описание
NDIS_STATUS_SUCCESS	Переопределенный драйвер успешно обработать событие PnP.
NDIS_STATUS_FAILURE	Не удалось выполнить событие PnP.

Замечания

NDIS вызывает функцию драйвера фильтра FilterNetPnPEvent, чтобы уведомить драйвер фильтра о событиях сетевого управления PnP и Power Management.

Драйверы фильтров могут перенаправлять эти уведомления на переопределяющие драйверы. Чтобы перенаправлять запрос, вызовите функцию NdisFNetPnPEvent из FilterNetPnPEvent.

Примечание драйверы NDIS не должны вызывать NdisFNetPnPEvent из контекста функции FilterOidRequest.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.0 и более поздних версиях.
целевая платформа	Настольный
заголовка	ndis.h (include Ndis.h)
библиотеки	Ndis.lib
IRQL	PASSIVE_LEVEL
правил соответствия DDI	Irql_Filter_Driver_Function(ndis)

См. также

FilterAttach

FilterNetPnPEvent

FilterOidRequest

NET_PNP_EVENT_NOTIFICATION

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