Macro NdisMCmDispatchIncomingCallQoSChange (ndis.h)

Artigo
02/29/2024

NdisMCmDispatchIncomingCallQoSChange 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 NdisMCmDispatchIncomingCallQoSChange(
   _H_,
   _P_
);

Parâmetros

_H_

Especifica o identificador para a VC para a qual a alteração no QoS está sendo solicitada. O driver MCM obteve esse identificador quando chamou NdisMCmCreateVc para configurar essa conexão para uma chamada de entrada ou como um parâmetro de entrada para sua função ProtocolCoCreateVc .

_P_

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 driver MCM chama NdisMCmDispatchIncomingCallQoSChange para notificar o cliente de que ele recebeu uma solicitação para modificar o QoS em uma conexão ativa. Esse driver MCM 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.

O driver MCM deve chamar NdisMCmActivateVc sempre que fizer alterações nos parâmetros de chamada para uma VC ativa.

Uma chamada para NdisMCmDispatchIncomingCallQoSChange 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 ele mantém sobre o 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 drivers de miniporto orientados à conexão que fornecem suporte integrado ao gerenciamento de chamadas podem chamar NdisMCmDispatchIncomingCallQoSChange. Os gerentes de chamadas autônomos, que se registram no NDIS como drivers de protocolo, chamam NdisCmDispatchIncomingCallQoSChange .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisMCmDispatchIncomingCallQoSChange (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisMCmDispatchIncomingCallQoSChange (NDIS 5.1)) no Windows XP.
Plataforma de Destino	Área de Trabalho
Cabeçalho	ndis.h (inclua Ndis.h)
IRQL	<= DISPATCH_LEVEL
Regras de conformidade de DDI	Irql_MCM_Function(ndis)