Compartir a través de

Función NdisMRegisterUnloadHandler (ndis.h)

  • Artículo

Nota NDIS 5. x está 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 Migración de controladores NDIS 5.x a NDIS 6.0.

La función NdisMRegisterUnloadHandler registra un controlador de descarga para un controlador.

Sintaxis

void NdisMRegisterUnloadHandler(
  [in] NDIS_HANDLE    NdisWrapperHandle,
  [in] PDRIVER_UNLOAD UnloadHandler
);

Parámetros

[in] NdisWrapperHandle

Especifica el identificador devuelto por NdisMInitializeWrapper.

[in] UnloadHandler

Especifica el punto de entrada para la rutina de descarga del controlador. Una rutina de descarga se declara de la siguiente manera:

VOID
(*PDRIVER_UNLOAD) (
    IN struct _DRIVER_OBJECT *DriverObject
    );

Valor devuelto

None

Observaciones

Un controlador llama a NdisMRegisterUnloadHandler desde su función DriverEntry después de que DriverEntry haya llamado a NdisMRegisterMiniport o NdisIMRegisterLayeredMiniport. NdisMRegisterUnloadHandler registra un controlador de descarga para el controlador.

La funcionalidad del controlador de descarga es específica del controlador. Por ejemplo, un controlador intermedio debe registrar un controlador de descarga que llame a NdisDeregisterProtocol para anular el registro de la parte del protocolo del controlador intermedio. El controlador de descarga también debe realizar las operaciones de limpieza necesarias, como la desasignación de recursos utilizados por la parte del protocolo del controlador.

Un controlador de minipuerto, como un controlador de minipuerto de equilibrio de carga, que supervisa más de una instancia de controlador de minipuerto debe registrar un controlador de descarga que limpie la información de estado y desasigne los recursos después de que se detengan las instancias del controlador de miniporte que supervisa. Tenga en cuenta que un controlador de descarga difiere de una función MiniportHalt : el controlador de descarga tiene un ámbito más global, mientras que el ámbito de la función MiniportHalt está restringido a una instancia de controlador de miniporte determinada.

  • Plataforma de destino: Universal
  • Versión: no se admite para controladores NDIS 6.0 en Windows Vista. Use NdisMRegisterMiniportDriveren su lugar. 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