Função NdisCloseAdapterEx (ndis.h)

  • Artigo

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.

Retornar valor

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 do A função ProtocolCloseAdapterCompleteEx quando a operação for concluída.

Comentários

Um driver de protocolo normalmente chama NdisCloseAdapterEx de sua Função ProtocolUnbindAdapterEx . O driver também pode chamar NdisCloseAdapterEx de sua função 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 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
Cliente mínimo com suporte Com suporte no NDIS 6.0 e posterior.
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)

Confira também

NdisOpenAdapterEx

NdisUnbindAdapter

ProtocolBindAdapterEx

ProtocolCloseAdapterCompleteEx

ProtocolUnbindAdapterEx