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 na QoS está sendo solicitada. O gerenciador de chamadas obteve originalmente 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.
Retornar valor
Nenhum
Comentários
Um gerenciador de chamadas autônomo chama NdisCmDispatchIncomingCallQoSChange para notificar o cliente de que ele recebeu uma solicitação para modificar a QoS em uma conexão ativa. Esse CM dá suporte a alterações dinâmicas de QoS em chamadas ativas, que é um recurso como a própria QoS que depende do protocolo de sinalização.
Quando o próprio CM recebe uma solicitação de alteração de QoS, o gerenciador de chamadas passa parâmetros de chamada modificados adequadamente para NdisCmActivateVc, de modo que o driver de miniporto subjacente também é notificado sobre a alteração de QoS proposta. Supondo que o driver de miniporto subjacente aceite os parâmetros de chamada alterados, o CM chama NdisCmDispatchIncomingCallQoSChange.
Uma chamada para NdisCmDispatchIncomingCallQoSChange faz com que o NDIS chame a função 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 mantém sobre a QoS para a 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 suporte integrado ao gerenciamento de chamadas chamam NdisMCmDispatchIncomingCallQoSChange .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisCmDispatchIncomingCallQoSChange (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_CallManager_Function(ndis) |