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 |
---|---|
|
NdisCloseAdapterEx fechou com êxito a associação ao adaptador de miniporto subjacente. |
|
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) |