NdisCmDispatchIncomingCallQoSChange, fonction (ndis.h)

Article
08/07/2023

NdisCmDispatchIncomingCallQoSChange 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 NdisCmDispatchIncomingCallQoSChange(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Paramètres

[in] NdisVcHandle

Spécifie le handle du vc pour lequel la modification de QoS est demandée. Le gestionnaire d’appels a obtenu ce handle à l’origine lorsqu’il a appelé NdisCoCreateVc pour configurer cette connexion pour un appel entrant ou en tant que paramètre d’entrée pour sa fonction ProtocolCoCreateVc .

[in] CallParameters

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 gestionnaire d’appels autonome appelle NdisCmDispatchIncomingCallQoSChange pour informer le client qu’il a reçu une demande de modification de la qualité de service sur une connexion active. Un tel cm 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.

Lorsque le cm lui-même reçoit une demande de modification de QoS, le gestionnaire d’appels transmet les paramètres d’appel modifiés de manière appropriée à NdisCmActivateVc, de sorte que le pilote miniport sous-jacent est également informé de la modification de qoS proposée. En supposant que le pilote miniport sous-jacent accepte les paramètres d’appel modifiés, le CM appelle ensuite NdisCmDispatchIncomingCallQoSChange.

Un appel à NdisCmDispatchIncomingCallQoSChange 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 gestionnaires d’appels autonomes, qui s’inscrivent eux-mêmes auprès de NDIS en tant que pilotes de protocole, peuvent appeler NdisCmDispatchIncomingCallQoSChange. Les pilotes miniport orientés connexion qui fournissent une prise en charge intégrée de la gestion des appels appellent À la place NdisMCmDispatchIncomingCallQoSChange .

Configuration requise

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