Macro NdisMCmModifyCallQoSComplete (ndis.h)

Article
02/26/2024

NdisMCmModifyCallQoSComplete indique l’achèvement de la demande du client, pour laquelle le pilote MCM a précédemment retourné NDIS_STATUS_PENDING, afin de modifier la qualité de service sur un vc.

Syntaxe

void NdisMCmModifyCallQoSComplete(
   _S_,
   _H_,
   _P_
);

Paramètres

_S_

Spécifie la status finale de la demande du client de modifier la qualité de service sur ce vc, soit NDIS_STATUS_SUCCESS, soit n’importe quel NDIS_STATUS_XXX déterminé par l’appelant, à l’exception de NDIS_STATUS_PENDING.

_H_

Spécifie le handle du vc, obtenu à partir de l’état par VC désigné par le CallMgrVcContext transmis au pilote MCM Fonction ProtocolCmModifyCallQoS pour cette requête.

_P_

Pointeur vers une structure de type CO_CALL_PARAMETERS spécifiant une Qualité de service acceptable pour le pilote MCM si Status est défini sur NDIS_STATUS_SUCCESS.

Valeur de retour

None

Remarques

Un appel à NdisMCmModifyCallQoSComplete amène NDIS à appeler le client Fonction ProtocolClModifyCallQoSComplete .

Le pilote MCM doit appeler NdisMCmActivateVc chaque fois qu’il apporte des modifications aux paramètres d’appel sur un vc actif.

Étant donné que le pilote MCM peut modifier les paramètres d’appel fournis par le client qui ont été entrés dans sa fonction ProtocolCmModifyCallQoS avant d’appeler NdisMCmModifyCallQoSComplete, la fonction ProtocolClModifyCallQoSComplete du client examine la QoS pour déterminer si elle est acceptable pour le client. ProtocolClModifyCallQoSComplete retourne simplement le contrôle si le client accepte les paramètres d’appel donnés. Dans le cas contraire, le client supprime 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 NdisMCmModifyCallQoSComplete. Les gestionnaires d’appels autonomes, qui s’inscrivent auprès de NDIS en tant que pilotes de protocole, appellent plutôt NdisCmModifyCallQoSComplete .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisMCmModifyCallQoSComplete (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (consultez NdisMCmModifyCallQoSComplete (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)