Função NdisUnbindAdapter (ndis.h)

  • Artigo

Os drivers de protocolo chamam a função NdisUnbindAdapter para solicitar que o NDIS feche uma associação a um adaptador de miniporte subjacente.

Sintaxe

NDIS_STATUS NdisUnbindAdapter(
  [in] NDIS_HANDLE NdisBindingHandle
);

Parâmetros

[in] NdisBindingHandle

Um identificador que o driver de protocolo obteve de uma chamada para a função NdisOpenAdapterEx . O identificador identifica a associação a ser fechada.

Retornar valor

NdisUnbindAdapter retorna um dos seguintes valores de status:

Código de retorno Descrição
NDIS_STATUS_SUCCESS
 NdisUnbindAdapter iniciou com êxito a operação desassociada.
NDIS_STATUS_RESOURCES
 O NdisUnbindAdapter falhou devido a recursos insuficientes.

Comentários

Os drivers de protocolo chamam NdisUnbindAdapter fora do contexto das funções ProtocolUnbindAdapterEx ou ProtocolBindAdapterEx . O NDIS agenda um item de trabalho para chamar a função ProtocolUnbindAdapterEx do driver de protocolo e retorna imediatamente.

Antes que a chamada para NdisUnbindAdapter retorne, o NDIS já pode ter fechado a associação. Portanto, depois que a chamada retorna, o chamador não deve assumir que o identificador passado para o parâmetro NdisBindingHandle ainda é válido.

Nota O NDIS pode não chamar ProtocolUnbindAdapterEx mesmo que NdisUnbindAdapter retorne NDIS_STATUS_SUCCESS.
 

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 <= DISPATCH_LEVEL
Regras de conformidade de DDI Irql_Protocol_Driver_Function(ndis)

Confira também

NdisOpenAdapterEx

ProtocolBindAdapterEx

ProtocolUnbindAdapterEx