Макрос NdisMResetComplete (NDIS 6.x)

  • Статья

Функция NdisMResetComplete возвращает окончательное состояние запроса на сброс, для которого драйвер мини-порта ранее вернул NDIS_STATUS_PENDING.

Синтаксис

void NdisMResetComplete(
  NDIS_HANDLE MiniportAdapterHandle,
  NDIS_STATUS Status,
  BOOLEAN     AddressingReset
);

Параметры

MiniportAdapterHandle

Адаптер мини-порта обрабатывает то, что NDIS первоначально передал в функцию MiniportInitializeEx .

Status

Окончательное состояние операции сброса только что завершена. Возвращаемые значения совпадают с значениями, указанными для функции обратного вызова MINIPORT_RESET.

AddressingReset

Логическое значение, равное TRUE , если NDIS отвечает за восстановление параметров адресов многоадресной рассылки, фильтров пакетов и сведений о разгрузке задач. В этом случае драйвер мини-порта отвечает за восстановление остальных параметров конфигурации сетевого интерфейса карта (NIC), на которые ссылается MiniportAdapterHandle.

Если Параметр AddressingReset имеет значение FALSE, драйвер мини-порта отвечает за восстановление всех параметров конфигурации сетевой карты.

Дополнительные сведения см. в разделе Сброс оборудования.

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

None

Remarks

Если функция MiniportResetEx возвращает NDIS_STATUS_PENDING, драйвер мини-порта должен вызвать NdisMResetComplete после завершения операции сброса.

Драйверы протокола не могут инициировать операцию сброса в NDIS 6.0 и более поздних версиях.

Некоторые сетевые карты теряют все адреса многоадресной рассылки, фильтр пакетов или функциональные адреса при выполнении обратимого сброса. Драйвер такой сетевой карты устанавливает для AddressingReset значениеTRUE при вызове NdisMResetComplete, в результате чего NDIS вызывает функцию MiniportOidRequest для восстановления состояния адресации. Дополнительные сведения см. в разделе Сброс оборудования.

Драйвер мини-порта должен освободить все блокировки спина, которые он удерживает, прежде чем вызывать NdisMResetComplete.

В NDIS 6.0 и более поздних версиях вызывающие средства NdisMResetComplete должны выполняться по адресу IRQL <= DISPATCH_LEVEL. В противном случае вызывающие средства NdisMResetComplete должны выполняться по адресу IRQL = DISPATCH_LEVEL.

Требования

Требование Значение
Минимальная версия клиента Windows Vista и более поздних версий
Верхняя часть ndis.h
IRQL <= DISPATCH_LEVEL
Правила соответствия DDI Irql_Miniport_Driver_Function(ndis)

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

Макрос NdisMResetComplete (NDIS 5.x)