Función NdisMDeregisterDevice (ndis.h)

  • Artículo

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

Consulte también