Função NdisCmDispatchIncomingCallQoSChange (ndis.h)
NdisCmDispatchIncomingCallQoSChange notifica um cliente de que uma solicitação para alterar a qualidade do serviço na conexão ativa desse cliente foi recebida pela rede.
Sintaxe
void NdisCmDispatchIncomingCallQoSChange(
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
Parâmetros
[in] NdisVcHandle
Especifica o identificador para a VC para a qual a alteração no QoS está sendo solicitada. O gerenciador de chamadas originalmente obteve esse identificador quando chamou NdisCoCreateVc para configurar essa conexão para uma chamada de entrada ou como um parâmetro de entrada para sua função ProtocolCoCreateVc.
[in] CallParameters
Ponteiro para uma estrutura do tipo CO_CALL_PARAMETERS que especifica o novo QoS, solicitado pelo cliente no nó remoto, para essa conexão.
Valor de retorno
Nenhum
Observações
Um gerenciador de chamadas autônomo chama NdisCmDispatchIncomingCallQoSChange para notificar o cliente de que ele recebeu uma solicitação para modificar o QoS em uma conexão ativa. Esse CM dá suporte a alterações dinâmicas de QoS em chamadas ativas, que é um recurso como o próprio QoS que depende do protocolo de sinalização.
Quando o cm em si recebe uma solicitação para uma alteração de QoS, o gerenciador de chamadas passa parâmetros de chamada modificados adequadamente para NdisCmActivateVc, portanto, o driver de miniporto subjacente também é notificado da alteração de QoS proposta. Supondo que o driver de miniporto subjacente aceite os parâmetros de chamada alterados, o CM então chama NdisCmDispatchIncomingCallQoSChange.
Uma chamada para NdisCmDispatchIncomingCallQoSChange faz com que o NDIS chame a função de ProtocolClIncomingQoSChange do cliente. O cliente aceita as modificações propostas nos parâmetros de chamada para a VC não fazendo nada, exceto possivelmente atualizando qualquer estado que ele mantém sobre o QoS para o VC e retornando o controle. Caso contrário, o cliente rejeitará a alteração de QoS proposta, derrubando a chamada.
Somente os gerenciadores de chamadas autônomos, que se registram no NDIS como drivers de protocolo, podem chamar NdisCmDispatchIncomingCallQoSChange. Drivers de miniporto orientados para conexão que fornecem chamada de suporte integrado de gerenciamento de chamadas NdisMCmDispatchIncomingCallQoSChange.