Compartilhar via

Função NdisMRegisterUnloadHandler (ndis.h)

Observação NDIS 5. x foi preterido e substituído pelo NDIS 6. x. Para obter um 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 o 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
    );

Valor de retorno

Nenhum

Observações

Um driver chama NdisMRegisterUnloadHandler de sua função DriverEntry depois que DriverEntry chamou 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 desregistificar a parte do 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 miniporto, como um driver de miniporto de balanceamento de carga, que monitora mais de uma instância de driver de miniporto 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. Use NdisMRegisterMiniportDriver. Com suporte para drivers NDIS 5.1 no Windows Vista e no Windows XP.

Requisitos

Requisito Valor
cabeçalho ndis.h (inclua Ndis.h)
biblioteca Ndis.lib
IRQL PASSIVE_LEVEL

Consulte também