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.
Retornar valor
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 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) |