Share via

Função NdisMRegisterUnloadHandler (ndis.h)

  • Artigo

Nota NDIS 5. x foi preterido e substituído pelo NDIS 6. x. Para obter o novo desenvolvimento de driver NDIS, consulte Drivers de rede começando com o Windows Vista. Para obter informações sobre como portar o NDIS 5. x drivers para NDIS 6. x, consulte Portabilidade de drivers NDIS 5.x para NDIS 6.0.

A função NdisMRegisterUnloadHandler registra um manipulador de descarregamento para um driver.

Sintaxe

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

Parâmetros

[in] NdisWrapperHandle

Especifica o identificador retornado por NdisMInitializeWrapper.

[in] UnloadHandler

Especifica o ponto de entrada para a rotina de descarregamento do driver. Uma rotina de descarregamento é declarada da seguinte maneira:

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

Retornar valor

Nenhum

Comentários

Um driver chama NdisMRegisterUnloadHandler de sua função DriverEntry depois que DriverEntry chamar NdisMRegisterMiniport ou NdisIMRegisterLayeredMiniport. NdisMRegisterUnloadHandler registra um manipulador de descarregamento para o driver.

A funcionalidade do manipulador de descarregamento é específica do driver. Por exemplo, um driver intermediário deve registrar um manipulador de descarregamento que chama NdisDeregisterProtocol para desregistrar a parte de protocolo do driver intermediário. O manipulador de descarregamento também deve executar todas as operações de limpeza necessárias, como desalocar recursos usados pela parte de protocolo do driver.

Um driver de miniporte, como um driver de miniporto de balanceamento de carga, que monitora mais de uma instância de driver de miniporte, deve registrar um manipulador de descarregamento que limpa as informações de estado e desaloca os recursos depois que as instâncias de driver de miniporto que ele monitora são interrompidas. Observe que um manipulador de descarregamento difere de uma função MiniportHalt : o manipulador de descarregamento tem um escopo mais global, enquanto o escopo da função MiniportHalt é restrito a uma instância específica do driver de miniport.

  • Plataforma de destino: Universal
  • Versão: não há suporte para drivers NDIS 6.0 no Windows Vista. Em vez disso, use NdisMRegisterMiniportDriver. Com suporte para drivers NDIS 5.1 no Windows Vista e windows XP.

Requisitos

Requisito Valor
Cabeçalho ndis.h (inclua Ndis.h)
Biblioteca Ndis.lib
IRQL PASSIVE_LEVEL

Confira também