Compartilhar via

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

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 está definida como NDIS_STATUS_SUCCESS no retorno dessa função.

[in] NdisProtocolHandle

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

Valor de retorno

Nenhum

Observações

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 de descarregamento configurada em seu objeto de 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 de descarregamento e outras rotinas de driver do modo kernel padrão, consulte Kernel-Mode Componentes de Driver.

  • 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 associações abertas, 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 o pendente abrir, se houver, tiver sido fechado, NdisDeregisterProtocol libera todos os filtros que seu chamador configurou e libera o NDIS de memória alocado 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. Use NdisDeregisterProtocolDriver. 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