Compartilhar via


Função NdisMCmDeactivateVc (ndis.h)

NdisMCmDeactivateVc notifica o NDIS de que não haverá mais transferências em uma VC ativa específica.

Sintaxe

NDIS_STATUS NdisMCmDeactivateVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parâmetros

[in] NdisVcHandle

Especifica o identificador que identifica a VC. Esse identificador foi fornecido pelo NDIS para o driver MCM quando ele chamou NdisMCmCreateVc para uma chamada de entrada ou quando sua função ProtocolCoCreateVc configurou a VC para uma chamada de saída iniciada pelo cliente.

Retornar valor

NdisMCmDeactivateVc pode retornar um dos seguintes:

Código de retorno Descrição
NDIS_STATUS_SUCCESS
O NDIS marcou a VC como inativa.
NDIS_STATUS_NOT_ACCEPTED
A VC já está desativada, portanto, essa chamada é redundante.

Comentários

Um driver MCM chama NdisMCmDeactivateVc como uma etapa essencial para fechar uma chamada, geralmente após a troca de pacotes com componentes de rede que rasgam a conexão.

Uma chamada bem-sucedida para NdisMCmDeactivateVc permite que o driver MCM descarte os parâmetros de chamada atuais para transferências na VC, possivelmente reinicializando-os para miniportar valores padrão determinados pelo driver. No entanto, se a VC for reativada posteriormente para outra chamada, o cliente fornecerá novos parâmetros de chamada ao driver de miniport.

O NdisVcHandle passado para NdisMCmDeactivateVc permanece válido após a conclusão da desativação de VC. A desativação de qualquer VC permite que seu criador reinicialize a VC para reutilização ou para destruí-la:

  • Após a desativação da VC e o fechamento da chamada, um cliente pode reutilizar uma VC criada originalmente para fazer outra chamada com NdisClMakeCall ou pode chamar NdisCoDeleteVc, causando assim uma chamada para a função ProtocolCoDeleteVc do driver MCM.
  • Após a desativação da VC e o fechamento da chamada, um driver MCM pode reutilizar uma VC criada originalmente para indicar outra chamada de entrada para o mesmo cliente com NdisMCmDispatchIncomingCall ou pode chamar NdisMCmDeleteVc.
O gravador de driver determina se um driver MCM tem uma função MiniportCoDeactivateVc (interna) que o driver chama no contexto de desativação de conexões para chamadas de saída e entrada.

Somente os drivers de miniporto orientados à conexão que fornecem suporte integrado ao gerenciamento de chamadas podem chamar NdisMCmDeactivateVc. Os gerentes de chamadas autônomos, que se registram no NDIS como drivers de protocolo, chamam NdisCmDeactivateVc .

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisMCmDeactivateVc (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisMCmDeactivateVc (NDIS 5.1)) no Windows XP.
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_MCM_Function(ndis)

Confira também

MiniportCoDeactivateVc

NdisClCloseCall

NdisClMakeCall

NdisCmDeactivateVc

NdisMCmActivateVc

NdisMCmDeleteVc

NdisMCmDispatchIncomingCall

ProtocolCmCloseCall

ProtocolCoDeleteVc