Compartir a través de

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. controladores x a NDIS 6. x, consulte Porting NDIS 5.x Drivers to 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 elimina el objeto de dispositivo y su objeto de vínculo simbólico asociado.

Observaciones

Un controlador llama a NdisMDeregisterDevice desde su Detener o función 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 de DriverEntry encuentra un error de inicialización irrecuperable, como una incapacidad para 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 de
  • 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
encabezado de ndis.h (incluya Ndis.h)
biblioteca de Ndis.lib
irQL PASSIVE_LEVEL

Consulte también