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

Примечание NDIS 5. x устарел и заменен NDIS 6. x. Сведения о разработке новых драйверов NDIS см. в статье Сетевые драйверы, начиная с Windows Vista. Сведения о переносе NDIS 5. драйверов x в NDIS 6. xсм. перенос драйверов NDIS 5.x в NDIS 6.0.

Функция NdisMRegisterUnloadHandler регистрирует обработчик выгрузки для драйвера.

Синтаксис

VOID NdisMRegisterUnloadHandler(
  [in] NDIS_HANDLE    NdisWrapperHandle,
  [in] PDRIVER_UNLOAD UnloadHandler
);

Параметры

[in] NdisWrapperHandle

Задает дескриптор, возвращаемый NdisMInitializeWrapper.

[in] UnloadHandler

Указывает точку входа для подпрограммы выгрузки драйвера. Подпрограмма выгрузки объявлена следующим образом:

VOID
(*PDRIVER_UNLOAD) (
    IN struct _DRIVER_OBJECT *DriverObject
    );

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

Никакой

Замечания

Драйвер вызывает NdisMRegisterUnloadHandler из функции DriverEntry после DriverEntry вызывает NdisMRegisterMiniport или NdisIMRegisterLayeredMiniport. NdisMRegisterUnloadHandler регистрирует обработчик выгрузки для драйвера.

Функциональные возможности обработчика выгрузки зависят от драйвера. Например, промежуточный драйвер должен зарегистрировать обработчик выгрузки, вызывающий NdisDeregisterProtocol для отмены регистрации части протокола промежуточного драйвера. Обработчик выгрузки также должен выполнять все необходимые операции очистки, такие как выделение ресурсов, используемых частью протокола драйвера.

Минипорт-драйвер, например драйвер минипорта балансировки нагрузки, который отслеживает несколько экземпляров драйвера минипорта, должен зарегистрировать обработчик выгрузки, который очищает сведения о состоянии и освобождает ресурсы после остановки экземпляров драйвера минипорта. Обратите внимание, что обработчик выгрузки отличается от функции MiniportHalt: обработчик выгрузки имеет более глобальную область, в то время как область действия функции MiniportHalt ограничена определенным экземпляром драйвера минипорта.

• Целевая платформа: универсальная
• Версия: не поддерживается для драйверов NDIS 6.0 в Windows Vista. Вместо этого используйте NdisMRegisterMiniportDriver. Поддерживается для драйверов NDIS 5.1 в Windows Vista и Windows XP.

Требования

См. также

• DriverEntry драйверов минипорта NDIS
• MiniportHalt
• NdisDeregisterProtocol
• NdisIMRegisterLayeredMiniport
• NdisMRegisterMiniport