Função NdisCmDeactivateVc (ndis.h)

Artigo
08/07/2023

NdisCmDeactivateVc notifica o NDIS e o driver de miniporto subjacente de que não haverá mais transferências em uma VC ativa específica.

Sintaxe

NDIS_STATUS NdisCmDeactivateVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parâmetros

[in] NdisVcHandle

Especifica o identificador que identifica a 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 a VC para uma chamada de saída iniciada pelo cliente.

Retornar valor

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 na VC, possivelmente reinicializando-os para miniportar valores padrão determinados pelo driver. Se a VC for reativada 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 desativação da VC ser concluída. A desativação de qualquer VC permite que seu criador reinicialize a VC para reutilização:

Após a desativação de VC e o fechamento da chamada, um cliente pode reutilizar uma VC criada originalmente para fazer outra chamada com NdisClMakeCall.
Após a desativação de VC e o fechamento da chamada, um CM pode reutilizar uma VC criada originalmente para indicar outra chamada de entrada para o mesmo cliente com NdisCmDispatchIncomingCall.

O criador de uma VC específica que não será reutilizado chama NdisCoDeleteVc para destruir essa 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

Requisito	Valor
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 de DDI	Irql_CallManager_Function(ndis)