Função NdisCmDispatchIncomingCallQoSChange (ndis.h)

Artigo
02/26/2024

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)