Função NdisMCmDeactivateVc (ndis.h)

Artigo
02/26/2024

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)