Macro NdisMCmDispatchIncomingCallQoSChange (ndis.h)
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) |