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

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

Функция NdisMDeregisterDevice удаляет из системы объект устройства, созданный с помощью NdisMRegisterDevice. NdisMDeregisterDevice также удаляет символьную ссылку, связанную с этим объектом устройства.

Синтаксис

NDIS_STATUS NdisMDeregisterDevice(
  [in] NDIS_HANDLE NdisDeviceHandle
);

Параметры

[in] NdisDeviceHandle

Указывает дескриптор, возвращаемый NdisMRegisterDevice , который идентифицирует объект устройства для отмены регистрации.

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

NdisMDeregisterDevice возвращает NDIS_STATUS_SUCCESS, если объект устройства и связанный с ним объект символьной ссылки удалены.

Комментарии

Драйвер вызывает NdisMDeregisterDevice из функции Halt или Unload , чтобы отменить регистрацию автономного объекта устройства, созданного ранее с помощью NdisMRegisterDevice. Драйвер должен вызывать NdisMDeregisterDevice при его выгрузке или при возникновении неустранимой ошибки инициализации, например невозможности получить системные ресурсы.

При вызове NdisMRegisterDevice не допускается никаких необработанных операций открытия в пользовательском режиме для удаляемого объекта устройства. Если они есть, возникает системная ошибка.

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

Требования

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

• MiniportHalt
• NdisMRegisterDevice
• NdisMRegisterUnloadHandler