Função NdisMCmActivateVc (ndis.h)

Artigo
02/26/2024

NdisMCmActivateVc notifica o NDIS de que um driver MCM está pronto para fazer transferências em uma VC específica.

Sintaxe

NDIS_STATUS NdisMCmActivateVc(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parâmetros

[in] NdisVcHandle

Especifica o identificador que identifica a VC.

[in] CallParameters

Ponteiro para um buffer alocado pelo chamador, formatado como uma estrutura do tipo CO_CALL_PARAMETERS, contendo todos os parâmetros específicos de mídia que o driver de miniporto usa para a VC ativada.

Retornar valor

Quando NdisMCmActivateVc retorna algo diferente de NDIS_STATUS_PENDING, o driver MCM deve fazer uma chamada interna para sua Função ProtocolCmActivateVcComplete . Caso contrário, o NDIS chamará a função ProtocolCmActivateVcComplete do driver MCM quando essa operação for concluída.

Comentários

O NdisMCmActivateVc informa ao NDIS que um driver MCM configurou parâmetros de chamada e mídia em uma VC recém-criada ou alterou os parâmetros de chamada em uma VC estabelecida.

Um driver MCM deve chamar NdisMCmActivateVc depois de estabelecer uma conexão em uma VC, mas antes que todos os dados sejam enviados ou recebidos nessa VC. Essa chamada notifica o NDIS de que o driver de miniporto preparou uma NIC para transferências na VC.

Para uma chamada de saída iniciada pelo cliente, um driver MCM geralmente chama NdisMCmActivateVc após o handshake denotando um contrato negociado com o nó remoto ou a configuração de chamada bem-sucedida na opção, antes de notificar o NDIS (e o cliente) de conclusão de chamada de saída com NdisMCmMakeCallComplete. Para uma chamada de entrada, um driver MCM geralmente chama NdisMCmActivateVc depois de ter chamado NdisMCmCreateVc com êxito e antes de chamar NdisMCmDispatchIncomingCall.

O gravador de driver determina se um driver MCM tem uma função MiniportCoActivateVc (interna) que o driver chama no contexto de configuração de conexões para chamadas de saída e de entrada.

Durante a conexão, um driver MCM pode modificar os parâmetros de chamada como condições na rede e/ou sempre que o cliente chamar NdisClModifyCallQoS. O driver MCM deve atualizar o estado que mantém sobre parâmetros de chamada para os novos valores se ele puder continuar a fazer transferências na VC de acordo com os parâmetros de chamada recém-modificados. Ele deve chamar NdisMCmActivateVc para notificar o NDIS de quaisquer alterações nos parâmetros de chamada para a VC ativa. Caso contrário, o driver MCM pode fazer um dos seguintes procedimentos:

Chame NdisMCmDeactivateVc depois de falhar na solicitação do cliente para modificar o QoS ou outros parâmetros de chamada para a VC para tal estado que o driver de miniporto não pode continuar a fazer transferências na VC.
Restaure os parâmetros de chamada para um estado aceito anteriormente, notifique o cliente que solicitou a alteração e permaneça pronto para continuar transferindo dados na VC. Nesse caso, o cliente tem a opção de aceitar os parâmetros de chamada restaurados ou rejeitá-los e iniciar um fechamento da VC.

Somente os drivers de miniporto orientados a conexão que fornecem suporte integrado ao gerenciamento de chamadas podem chamar NdisMCmActivateVc. Os gerenciadores de chamadas autônomos, que se registram no NDIS como drivers de protocolo, chamam NdisCmActivateVc .

Requisitos

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