NdisClModifyCallQoS, fonction (ndis.h)

Article
07/02/2025

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)