Partilhar via

Função NdisCloseAdapter (ndis.h)

  • Artigo

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.

NdisCloseAdapter libera a associação estabelecida e os recursos alocados quando o protocolo chamado NdisOpenAdapter.

Sintaxe

void NdisCloseAdapter(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  NdisBindingHandle
);

Parâmetros

[out] Status

Ponteiro para uma variável fornecida pelo chamador na qual essa função retorna o status da operação de fechamento, que pode ser um dos seguintes valores:

  • NDIS_STATUS_SUCCESS
    A associação foi fechada e todos os recursos referentes a essa associação foram liberados.

  • NDIS_STATUS_PENDING
    Uma solicitação de adaptador próximo está sendo tratada de forma assíncrona e a função ProtocolCloseAdapterComplete do chamador será chamada quando a operação de fechamento for concluída.

[in] NdisBindingHandle

Especifica o identificador retornado por NdisOpenAdapter que identifica o adaptador virtual ou a NIC a ser fechada.

Valor de retorno

Nenhum

Observações

Valor retornado: Nenhum

Um driver de protocolo normalmente chama NdisCloseAdapter de sua função ProtocolUnbindAdapter. Ele também pode chamar NdisCloseAdapter de sua funçãoProtocolBindAdapter, por exemplo, se não tiver definido um valor OID depois de chamar NdisOpenAdapter para configurar uma associação.

Assim que um protocolo chama NdisCloseAdapter, o identificador em NdisBindingHandle deve ser considerado inválido pelo chamador. É um erro de programação passar esse identificador em qualquer chamada subsequente para uma função NdisXxx.

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