Share via

Função NdisDeregisterProtocol (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.

NdisDeregisterProtocol libera os recursos alocados quando o driver chamado NdisRegisterProtocol.

Sintaxe

void NdisDeregisterProtocol(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  NdisProtocolHandle
);

Parâmetros

[out] Status

Ponteiro para uma variável fornecida pelo chamador que é definida como NDIS_STATUS_SUCCESS no retorno dessa função.

[in] NdisProtocolHandle

Especifica o identificador retornado por NdisRegisterProtocol quando o driver é inicializado.

Retornar valor

Nenhum

Comentários

Os drivers de protocolo registrados chamam NdisDeregisterProtocol em qualquer uma das seguintes circunstâncias:

  • O driver já chamado NdisRegisterProtocol com êxito , mas não pode se associar a nenhum driver NDIS subjacente no computador.

  • O motorista está sendo descarregado. Ou seja, a rotina unload configurada em seu objeto driver durante a inicialização foi chamada ou a função ProtocolUnbindAdapter foi chamada para liberar a última associação restante do driver.

    Para obter mais informações sobre a rotina Descarregue e outras rotinas padrão do driver no modo kernel, consulte Componentes do driver do modo Kernel.

  • O sistema está sendo desligado. Como o driver, que é um protocolo de nível mais alto, chamado IoRegisterShutdownNotification quando inicializado, sua rotina de desligamento foi chamada.

    Consulte IoRegisterShutdownNotification para obter mais informações.

Se um protocolo tiver alguma associação aberta, sua chamada para NdisDeregisterProtocol fará com que o NDIS chame a função ProtocolUnbindAdapter do protocolo uma vez para cada associação aberta. ProtocolUnbindAdapter chama NdisCloseAdapter para fechar a associação.

Quando pendente é aberto, se houver, foi fechado, NdisDeregisterProtocol libera todos os filtros que seu chamador configurou e libera a memória NDIS alocada para rastrear associações e filtros para o driver de protocolo.

  • Plataforma de destino: Universal
  • Versão: não há suporte para drivers NDIS 6.0 no Windows Vista. Em vez disso, use NdisDeregisterProtocolDriver. 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