Макрос NdisMResetComplete (ndis.h)

  • Статья

Примечание

Для NDIS 6.x (Windows Vista и более поздних версий) используйте функцию NdisMResetComplete (NDIS 6.x).

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

Синтаксис

void NdisMResetComplete(
   _M,
   _S,
   _A
);

Параметры

_M

Дескриптор адаптера мини-порта, который NDIS изначально передал функции MiniportInitializeEx .

_S

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

_A

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

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

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

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

None

Remarks

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

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

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

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

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

Требования

Требование Значение
Минимальная версия клиента Поддерживается в NDIS 5.1 и NDIS 6.0 и более поздних версиях. Драйверы NDIS 5.1 см. в разделе NdisMResetComplete (NDIS 5.1).
Целевая платформа Универсальное
Верхняя часть ndis.h (включая Ndis.h)
Библиотека Ndis.lib
IRQL DISPATCH_LEVEL
Правила соответствия DDI Irql_Miniport_Driver_Function(ndis)

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

MiniportInitializeEx

MiniportOidRequest

MiniportResetEx

Функция NdisMResetComplete (NDIS 6.x)