Compartilhar via


Função NdisCloseAdapter (ndis.h)

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.

O 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 relativos 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 NIC a ser fechado.

Retornar valor

Nenhum

Comentários

Valor de retorno: nenhum

Um driver de protocolo normalmente chama NdisCloseAdapter de sua função ProtocolUnbindAdapter . Ele também pode chamar NdisCloseAdapter de sua função ProtocolBindAdapter , 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 windows XP.

Requisitos

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

Confira também