Функция 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) |