NdisClModifyCallQoS, fonction (ndis.h)
NdisClModifyCallQoS demande une modification de la qualité du service sur une connexion.
Syntaxe
NDIS_STATUS NdisClModifyCallQoS(
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
Paramètres
[in] NdisVcHandle
Spécifie le handle pour lequel le client souhaite modifier la Qualité de service. Le client a obtenu ce handle à l’origine en appelant NdisCoCreateVc, et, plus récemment, a récupéré ce handle à partir de sa zone d’état par VC.
[in] CallParameters
Pointeur vers une structure de type CO_CALL_PARAMETERS qui spécifie la nouvelle QoS demandée par l’appelant.
Valeur de retour
Lorsque NdisClModifyCallQoS retourne quelque chose d’autre que NDIS_STATUS_PENDING, le client doit effectuer un appel interne à son ProtocolClModifyCallQoSComplete fonction. Sinon, NDIS appelle la fonction ProtocolClModifyCallQoSComplete du client lorsque cette opération est terminée.
Remarques
Un appel à NdisClModifyCallQoS entraîne l’appel de NDIS ProtocolCmModifyCallQoS fonction, qui, à son tour, appelle NdisCmActivateVc pour avertir le pilote miniport sous-jacent de modifier les paramètres d’appel si la modification qoS demandée peut être effectuée.
Si le gestionnaire d’appels n’accepte pas la modification de qoS proposée par le client, le client peut continuer à utiliser la QoS inchangée pour l’appel ou supprimer l’appel. Si le client et le gestionnaire d’appels ne peuvent pas s’entendre sur la QoS pour un appel particulier, le créateur de la vc est chargé de lancer la suppression du vc.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisClModifyCallQoS (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisClModifyCallQoS (NDIS 5.1)) dans Windows XP. |
| plateforme cible | Bureau |
| d’en-tête | ndis.h (include Ndis.h) |
| bibliothèque | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| règles de conformité DDI | Irql_Protocol_Driver_Function(ndis) |