Partilhar via


Função NdisCloseAdapterEx (ndis.h)

Um driver de protocolo chama a função NdisCloseAdapterEx para liberar a associação e os recursos que foram alocados quando o driver chamou a função NdisOpenAdapterEx.

Sintaxe

NDIS_STATUS NdisCloseAdapterEx(
  [in] NDIS_HANDLE NdisBindingHandle
);

Parâmetros

[in] NdisBindingHandle

O identificador que o NDIS forneceu no parâmetro NdisBindingHandle de NdisOpenAdapterEx. Esse identificador identifica a associação que o NDIS deve fechar.

Valor de retorno

NdisCloseAdapterEx retorna um dos seguintes valores de status:

Código de retorno Descrição
NDIS_STATUS_SUCCESS
NdisCloseAdapterEx fechou com êxito a associação ao adaptador de miniporto subjacente.
NDIS_STATUS_PENDING
NdisCloseAdapterEx não concluiu a operação de fechamento e a operação será concluída de forma assíncrona. O NDIS chama o driver de protocolo função ProtocolCloseAdapterCompleteEx quando a operação for concluída.

Observações

Um driver de protocolo normalmente chama NdisCloseAdapterEx de sua função ProtocolUnbindAdapterEx. O driver também pode chamar NdisCloseAdapterEx de sua função de ProtocolBindAdapterEx. Por exemplo, se o driver não tiver definido um valor OID depois de chamar NdisOpenAdapterEx, ele poderá chamar NdisCloseAdapterEx de sua função de ProtocolBindAdapterEx.

Se um driver de protocolo precisar fechar um adaptador de miniporto fora do contexto de ProtocolUnbindAdapterEx ou ProtocolBindAdapterEx, ele deverá chamar a função NdisUnbindAdapter.

Os drivers de protocolo devem aguardar todas as solicitações de envio e solicitações OID originadas para serem concluídas antes de chamar NdisCloseAdapterEx.

Assim que o driver chama NdisCloseAdapterEx, o identificador obtido da função NdisOpenAdapterEx no parâmetro NdisBindingHandle torna-se inválido.

Requisitos

Requisito Valor
de cliente com suporte mínimo Com suporte no NDIS 6.0 e posterior.
da Plataforma de Destino Área de trabalho
cabeçalho ndis.h (inclua Ndis.h)
biblioteca Ndis.lib
IRQL PASSIVE_LEVEL
regras de conformidade de DDI Irql_Protocol_Driver_Function(ndis)

Consulte também

NdisOpenAdapterEx

NdisUnbindAdapter

ProtocolBindAdapterEx

ProtocolCloseAdapterCompleteEx

ProtocolUnbindAdapterEx