NdisCmDispatchIncomingCallQoSChange, fonction (ndis.h)
NdisCmDispatchIncomingCallQoSChange avertit un client qu’une demande de modification de la qualité du 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 pour lequel la modification de QoS est demandée. Le gestionnaire d’appels a obtenu à l’origine ce handle lorsqu’il a appelé NdisCoCreateVc pour configurer cette connexion pour un appel entrant ou en tant que paramètre d’entrée à 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
Aucun
Remarques
Un gestionnaire d’appels autonome appelle NdisCmDispatchIncomingCallQoSChange pour informer le client qu’il a reçu une demande de modification de qoS sur une connexion active. Un tel cm prend en charge les modifications dynamiques de qoS sur les appels actifs, qui est une fonctionnalité telle que QoS elle-même qui dépend du protocole de signalisation.
Lorsque la cm elle-même reçoit une demande de modification qoS, le gestionnaire d’appels transmet les paramètres d’appel correctement modifiés à NdisCmActivateVc, de sorte que le pilote miniport sous-jacent est également averti 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 la vc en n’effectuant rien, sauf éventuellement la mise à jour de l’état qu’il conserve sur la QoS pour la vc et le retour du contrôle. Sinon, le client rejette la modification de qoS proposée en déchirant l’appel.
Seuls les gestionnaires d’appels autonomes, qui s’inscrivent 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 NdisMCmDispatchIncomingCallQoSChange à la place.