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

Статья
08/07/2023

Драйверы мини-портов NDIS (и промежуточные драйверы, зарегистрированные в качестве драйверов минипорта) вызывают функцию NdisMNetPnPEvent для создания события сетевого Plug and Play, события NDIS PnP или события управления питанием или распространения его на слишком распространенные драйверы.

Синтаксис

NDIS_STATUS NdisMNetPnPEvent(
  [in] NDIS_HANDLE                 MiniportAdapterHandle,
       PNET_PNP_EVENT_NOTIFICATION NetPnPEventNotification
);

Параметры

[in] MiniportAdapterHandle

NDIS обрабатывает NDIS, предоставленный в параметре MiniportAdapterHandle функции MiniportInitializeEx . Этот дескриптор идентифицирует адаптер мини-порта, на который влияет событие. Если вызывающий объект является промежуточным драйвером, это дескриптор виртуального мини-порта.

NetPnPEventNotification

Указатель на NET_PNP_EVENT_NOTIFICATION структуры, описывающей событие сетевого Plug and Play, событие NDIS PnP или событие управления питанием.

Важно!

Если для поля VPortIdnetPnpEventNotification задано значение, отличное от NDIS_DEFAULT_VPORT_ID, то член Flags должен иметь значение NET_EVENT_FLAGS_VPORT_ID_VALID, чтобы VPortId войл в силу.

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

NdisMNetPnPEvent может возвращать следующее:

Код возврата	Описание
NDIS_STATUS_SUCCESS	Переопределяющие драйверы успешно обработали событие Plug and Play или Power Management.
NDIS_STATUS_RESOURCES	Не удалось получить системные ресурсы, необходимые для выполнения указанного события Plug and Play или управления питанием.
NDIS_STATUS_INVALID_PARAMETER	NDIS не удалось выполнить вызов, так как некоторые входные параметры недопустимы.
NDIS_STATUS_NOT_SUPPORTED	Драйверы протокола NDIS 6.0 и более поздних версий не должны возвращать это состояние. NDIS 5. Драйвер протокола x, который не поддерживает Plug and Play, может вернуть это состояние в ответ на NetEventSetPower, чтобы указать, что NDIS должен отменить привязку к базовому адаптеру.
NDIS_STATUS_INVALID_PORT	NDIS не удалось выполнить запрос, так как в событии PnP NetEventPortActivation или NetEventPortDeactivation был указан недопустимый порт NDIS.
NDIS_STATUS_INVALID_PORT_STATE	NDIS не удалось выполнить запрос, так как порт NDIS находился в недопустимом состоянии порта. Порты указываются в событии PnP NetEventPortActivation или NetEventPortDeactivation .
NDIS_STATUS_FAILURE	Не удалось обработать распространяемое событие Plug and Play или Power Management.

Возвращаемое значение имеет значение, только если распространяемое событие является событием NetEventQueryPower или NetEventQueryRemoveDevice . Для всех остальных распространяемых событий возвращаемое значение всегда NDIS_STATUS_SUCCESS.

Если событие имеет значение NetEventPortActivation и вызов завершается сбоем, вызывающий объект не должен использовать связанные порты в обозначениях получения или состояния.

Любой драйвер мини-порта может вызывать NdisMNetPnPEvent для создания событий NetEventPortActivation и NetEventPortDeactivation . Только промежуточные драйверы могут создавать другие уведомления о событиях.

Примечание Чтобы предотвратить взаимоблокировку, драйвер NDIS должен сделать следующее:

Функция MiniportOidRequest не должна вызывать NdisMNetPnPEvent.
Если функция MiniportOidRequest возвращает NDIS_STATUS_PENDING для запроса OID, драйвер NDIS не должен вызывать NdisMNetPnPEvent , пока не завершит запрос OID путем вызова NdisMOidRequestComplete.

Чтобы распространить уведомление о событии сетевого Plug and Play, событии NDIS PnP или событии управления питанием на более скользящие драйверы, промежуточный драйвер NDIS вызывает NdisMNetPnPEvent в контексте функции ProtocolNetPnPEvent драйвера.

Если распространяемое событие является NetEventQueryPower или NetEventQueryRemoveDevice, промежуточный драйвер должен проверка значение NDIS_STATUS, возвращаемое NdisMNetPnPEvent. Если возвращенное состояние NDIS_STATUS_SUCCESS, промежуточный драйвер должен обработать событие, а затем вернуть NDIS_STATUS_SUCCESS из функции ProtocolNetPnPEvent . Если возвращенное состояние не NDIS_STATUS_SUCCESS, промежуточный драйвер должен возвращать сообщаемое состояние из функции ProtocolNetPnPEvent без дальнейшей обработки.

То, как промежуточный драйвер обрабатывает NetEventSetPower , полученный функцией ProtocolNetPnPEvent, зависит от указанного состояния питания устройства. Если указанное состояние питания устройства — NdisDeviceStateD0, промежуточный драйвер должен обработать событие, а затем вызвать NdisMNetPnPEvent. Для любого другого указанного состояния питания устройства промежуточный драйвер должен сначала вызвать NdisMNetPnPEvent , а затем обработать событие .

Промежуточный драйвер должен вызывать NdisMNetPnPEvent для распространения NetEventReconfigure или NetEventBindList только в том случае, если NetEventReconfigure или NetEventBindList указан в protocolBindingContext, отличном от NULL. Если netEventReconfigure или NetEventBindList указан в nullProtocolBindingContext, промежуточный драйвер не должен вызывать NdisMNetPnPEvent для распространения события.

Если промежуточный драйвер обрабатывает NetEventReconfigure или NetEventBindList, он должен проверять все данные, связанные с событием.

Промежуточный драйвер не должен распространять события NetEventBindsComplete, NetEventPause, NetEventRestart, NetEventPortActivation или NetEventPortDeactivation путем вызова NdisMNetPnPEvent.

Промежуточный драйвер NDIS может создавать собственные события порта NDIS для виртуальных мини-портов в соответствии с событиями NetEventPortActivation или NetEventPortDeactivation , которые он получает в своей функции ProtocolNetPnPEvent .

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

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.0 и более поздних версиях.
Целевая платформа	Универсальное
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	PASSIVE_LEVEL
Правила соответствия DDI	Irql_Protocol_Driver_Function(ndis), NdisMNetPnPEventInOIDRequest(ndis)

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

MiniportInitializeEx

MiniportOidRequest

NET_PNP_EVENT_NOTIFICATION

ProtocolNetPnPEvent

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