NdisCmDispatchIncomingCallQoSChange, fonction (ndis.h)
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) |