Função NdisCmDeactivateVc (ndis.h)

NdisCmDeactivateVc notifica o NDIS e o driver de miniporto subjacente de que não haverá mais transferências em um VC ativo específico.

Sintaxe

NDIS_STATUS NdisCmDeactivateVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parâmetros

[in] NdisVcHandle

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

Valor retornado

Quando NdisCmDeactivateVc retorna qualquer coisa diferente de NDIS_STATUS_PENDING, o gerenciador de chamadas deve fazer uma chamada interna para sua Função ProtocolCmDeactivateVcComplete . Caso contrário, o NDIS chamará a função ProtocolCmDeactivateVcComplete do CM quando essa operação for concluída.

Comentários

Um gerenciador de chamadas autônomo chama NdisCmDeactivateVc como uma etapa essencial para fechar uma chamada, geralmente após a troca de pacotes com componentes de rede que rasgam a chamada.

Uma chamada para NdisCmDeactivateVc faz com que o NDIS chame a função MiniportCoDeactivateVc do driver de miniport subjacente, que pode descartar os parâmetros de chamada atuais para transferências no VC, possivelmente reinicializando-os para miniportar valores padrão determinados pelo driver. Se o VC for reativado posteriormente para outra chamada, o cliente ou o gerenciador de chamadas fornecerá novos parâmetros de chamada ao driver de miniport.

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

  • Após a desativação de VC e o fechamento da chamada, um cliente pode reutilizar um VC criado originalmente para fazer outra chamada com NdisClMakeCall.
  • Após a desativação de VC e o fechamento da chamada, um CM pode reutilizar um VC criado originalmente para indicar outra chamada de entrada para o mesmo cliente com NdisCmDispatchIncomingCall.
O criador de um VC específico que não será reutilizado chama NdisCoDeleteVc para destruir esse VC.

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

Requisitos

   
Cliente mínimo com suporte Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisCmDeactivateVc (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisCmDeactivateVc (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 DDI Irql_CallManager_Function(ndis)

Confira também

MiniportCoDeactivateVc

NdisClCloseCall

NdisClMakeCall

NdisCmActivateVc

NdisCmDispatchIncomingCall

NdisMCmDeactivateVc

ProtocolCmCloseCall

ProtocolCmDeactivateVcComplete