Função NdisCmDeactivateVc (ndis.h)
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 configurar o VC para uma chamada de saída iniciada pelo cliente.
Valor de retorno
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.
Observações
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 miniporto 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 a VC for reativada posteriormente para outra chamada, o cliente ou o gerenciador de chamadas fornecerá novos parâmetros de chamada ao driver de miniporto.
O NdisVcHandle passado para NdisCmDeactivateVc permanece válido após a desativação de VC ser concluída. 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.
Somente os gerenciadores 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 chamada de suporte integrado de gerenciamento de chamadas NdisMCmDeactivateVc.