Função NdisMCmActivateVc (ndis.h)
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.
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) |