Macro NdisMCmDispatchIncomingCallQoSChange (ndis.h)

Article
03/01/2024

NdisMCmDispatchIncomingCallQoSChange avertit un client qu’une demande de modification de la qualité de service sur la connexion active de ce client a été reçue sur le réseau.

Syntaxe

void NdisMCmDispatchIncomingCallQoSChange(
   _H_,
   _P_
);

Paramètres

_H_

Spécifie le handle du vc pour lequel la modification de QoS est demandée. Le pilote MCM a obtenu ce handle soit lorsqu’il a appelé NdisMCmCreateVc pour configurer cette connexion pour un appel entrant, soit en tant que paramètre d’entrée pour sa fonction ProtocolCoCreateVc .

_P_

Pointeur vers une structure de type CO_CALL_PARAMETERS qui spécifie la nouvelle QoS, demandée par le client sur le nœud distant, pour cette connexion.

Valeur de retour

None

Remarques

Un pilote MCM appelle NdisMCmDispatchIncomingCallQoSChange pour informer le client qu’il a reçu une demande de modification de la Qualité de service sur une connexion active. Un tel pilote MCM prend en charge les modifications de QoS dynamiques sur les appels actifs, qui est une fonctionnalité telle que QoS elle-même qui dépend du protocole de signalisation.

Le pilote MCM doit appeler NdisMCmActivateVc chaque fois qu’il apporte des modifications aux paramètres d’appel d’un vc actif.

Un appel à NdisMCmDispatchIncomingCallQoSChange amène NDIS à appeler la fonction ProtocolClIncomingQoSChange du client. Le client accepte les modifications proposées aux paramètres d’appel pour le vc en ne faisant rien, à l’exception éventuellement de la mise à jour de tout état qu’il maintient sur la QoS pour le vc et en retournant le contrôle. Sinon, le client rejette la modification qoS proposée en supprimant l’appel.

Seuls les pilotes miniport orientés connexion qui fournissent une prise en charge intégrée de la gestion des appels peuvent appeler NdisMCmDispatchIncomingCallQoSChange. Les gestionnaires d’appels autonomes, qui s’inscrivent eux-mêmes auprès de NDIS en tant que pilotes de protocole, appellent plutôt NdisCmDispatchIncomingCallQoSChange .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisMCmDispatchIncomingCallQoSChange (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisMCmDispatchIncomingCallQoSChange (NDIS 5.1)) dans Windows XP.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ndis.h (inclure Ndis.h)
IRQL	<= DISPATCH_LEVEL
Règles de conformité DDI	Irql_MCM_Function(ndis)