Функция 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.
Требования
Требование | Значение |
---|---|
Заголовок | ndis.h (включая Ndis.h) |
Библиотека | Ndis.lib |
IRQL | PASSIVE_LEVEL |