Fonction NdisClModifyCallQoS (ndis.h)

Article
03/01/2024

NdisClModifyCallQoS demande une modification de la qualité de 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 du vc pour lequel le client souhaite modifier la qualité de service. Le client a initialement obtenu ce handle 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 retournée

Lorsque NdisClModifyCallQoS retourne autre chose que NDIS_STATUS_PENDING, le client doit effectuer un appel interne à son Fonction ProtocolClModifyCallQoSComplete . Sinon, NDIS appelle la fonction ProtocolClModifyCallQoSComplete du client lorsque cette opération est terminée.

Remarques

Un appel à NdisClModifyCallQoS amène NDIS à appeler les cm Fonction ProtocolCmModifyCallQoS , 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 qoS proposée par le client, il peut continuer à utiliser la qualité de service inchangée pour l’appel ou supprimer l’appel. Si le client et le gestionnaire d’appels ne parvient pas à s’entendre sur la qualité de service d’un appel particulier, le créateur du vc est responsable de l’initiation de la suppression du vc.

Configuration requise

Condition requise	Valeur
Client minimal 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 (consultez NdisClModifyCallQoS (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_Protocol_Driver_Function(ndis)