Función NdisMDeregisterDevice (ndis.h)
Nota NDIS 5. x ha quedado en desuso y se sustituye por NDIS 6. x. Para el nuevo desarrollo de controladores NDIS, consulte Controladores de red a partir de Windows Vista. Para obtener información sobre cómo migrar NDIS 5. x controladores a NDIS 6. x, consulte Migración de controladores NDIS 5.x a NDIS 6.0.
La función NdisMDeregisterDevice quita del sistema un objeto de dispositivo que se creó con NdisMRegisterDevice. NdisMDeregisterDevice también quita el vínculo simbólico asociado a este objeto de dispositivo.
Sintaxis
NDIS_STATUS NdisMDeregisterDevice(
[in] NDIS_HANDLE NdisDeviceHandle
);
Parámetros
[in] NdisDeviceHandle
Especifica el identificador devuelto por NdisMRegisterDevice que identifica el objeto de dispositivo que se va a anular el registro.
Valor devuelto
NdisMDeregisterDevice devuelve NDIS_STATUS_SUCCESS si se eliminan el objeto de dispositivo y su objeto de vínculo simbólico asociado.
Comentarios
Un controlador llama a NdisMDeregisterDevice desde su función Halt o Unload para anular el registro de un objeto de dispositivo independiente que creó anteriormente con NdisMRegisterDevice. El controlador debe llamar a NdisMDeregisterDevice cuando se descarga o cuando su rutina DriverEntry encuentra un error de inicialización irrecuperable, como la incapacidad de obtener recursos del sistema.
Cuando se llama a NdisMRegisterDevice , no puede haber ninguna operación abierta en modo de usuario pendiente en el objeto de dispositivo que se va a eliminar. Si hay, se produce un error del sistema.
- Plataforma de destino: Universal
- Versión: no se admite para controladores NDIS 6.0 en Windows Vista. Compatible con controladores NDIS 5.1 en Windows Vista y Windows XP.
Requisitos
| Requisito | Valor |
|---|---|
| Header | ndis.h (incluya Ndis.h) |
| Library | Ndis.lib |
| IRQL | PASSIVE_LEVEL |