Função NdisMCmActivateVc (ndis.h)
NdisMCmActivateVc notifica o NDIS de que um driver MCM está pronto para fazer transferências em um VC específico.
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 por 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.
Valor de retorno
Quando NdisMCmActivateVc retorna qualquer coisa 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.
Observações
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 deixou uma NIC pronta 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 acordo negociado com o nó remoto ou configuração de chamada bem-sucedida na opção, antes de notificar o NDIS (e o cliente) da conclusão da chamada de saída com NdisMCmMakeCallComplete. Para uma chamada de entrada, um driver MCM geralmente chama NdisMCmActivateVc depois de chamar NdisMCmCreateVc com êxito e antes de chamar NdisMCmDispatchIncomingCall.
O gravador de driver determina se um driver MCM tem uma função MiniportCoActivateVc 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 alteração de rede e/ou sempre que o cliente chama NdisClModifyCallQoS. O driver MCM deve atualizar o estado que mantém sobre os 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 o VC ativo. 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 o 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 |
|---|---|
| de cliente com suporte mínimo | 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. |
| da 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) |