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

  • Статья

Функция NdisReEnumerateProtocolBindings заставляет NDIS вызывать функцию ProtocolBindAdapterEx драйвера протокола один раз для каждого адаптера минипорта, для которого настроена привязка драйвера, но к которому драйвер в настоящее время не привязан.

Синтаксис

void NdisReEnumerateProtocolBindings(
  [in] NDIS_HANDLE NdisProtocolHandle
);

Параметры

[in] NdisProtocolHandle

Дескриптор, представляющий драйвер вызывающего протокола. Драйвер получил этот дескриптор с помощью предыдущего вызоваФункция NdisRegisterProtocolDriver.

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

None

Remarks

Драйвер протокола может вызвать функцию NdisReEnumerateProtocolBindings для повторной привязки к одному или нескольким адаптерам минипорта.

Драйверы протокола не могут вызывать NdisReEnumerateProtocolBindings из контекста ProtocolBindAdapterEx, или Функции ProtocolUnbindAdapterEx . Кроме того, драйверы протокола не могут вызывать NdisReEnumerateProtocolBindings из контекста функции ProtocolNetPnPEvent , если
Параметр ProtocolBindingContextобъекта ProtocolNetPnPEvent не имеет значения NULL. Однако драйверы протоколов могут вызывать NdisReEnumerateProtocolBindings из контекста ProtocolNetPnPEvent, если ProtocolBindingContext имеет значение NULL. Значение NULLProtocolBindingContext указывает, что событие применяется ко всем привязкам.

NDIS может завершить операции привязки после возврата вызова NdisReEnumerateProtocolBindings . То есть NDIS может выполнять привязки к адаптерам минипорта, для которых настроена привязка драйвера протокола, но к которым драйвер протокола в настоящее время не привязан позже.

Промежуточный драйвер должен вызывать NdisReEnumerateProtocolBindings после того, как его функция ProtocolNetPnPEvent получает NetEventReconfigure в nullProtocolBindingContext . Затем NDIS вызывает функцию ProtocolBindAdapterEx драйвера один раз для каждого адаптера минипорта, для которого драйвер настроен для привязки, но к которому драйвер в настоящее время не привязан.

Требования

Требование Значение
Минимальная версия клиента Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisReEnumerateProtocolBindings (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. раздел NdisReEnumerateProtocolBindings (NDIS 5.1)) в Windows XP.
Целевая платформа Персональный компьютер
Верхняя часть ndis.h (включая Ndis.h)
Библиотека Ndis.lib
IRQL PASSIVE_LEVEL
Правила соответствия DDI Irql_Miscellaneous_Function(ndis), NdisReEnumerateProtocolBindings(ndis)

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

MiniportInitializeEx

NdisRegisterProtocolDriver

ProtocolBindAdapterEx

ProtocolNetPnPEvent

ProtocolUnbindAdapterEx