NdisClIncomingCallComplete, fonction (ndis.h)

Article
02/26/2024

NdisClIncomingCallComplete renvoie l’acceptation ou le rejet d’un appel entrant proposé par un client, pour lequel la fonction ProtocolClIncomingCall du client a précédemment renvoyé NDIS_STATUS_PENDING.

Syntaxe

void NdisClIncomingCallComplete(
  [in] NDIS_STATUS         Status,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Paramètres

[in] Status

Est défini sur NDIS_STATUS_SUCCESS si le client accepte l’appel proposé. Sinon, ce paramètre peut être défini sur n’importe quel NDIS_STATUS_XXX , sauf NDIS_STATUS_PENDING pour indiquer la raison déterminée par le client pour rejeter l’appel.

[in] NdisVcHandle

Spécifie le handle du vc créé par le gestionnaire d’appels pour représenter l’appel entrant. Le client a obtenu ce handle à partir de son état par vc désigné par le ProtocoleVcContext passé en tant que paramètre d’entrée à son Fonction ProtocolClIncomingCall .

[in] CallParameters

Pointeur vers une structure de type CO_CALL_PARAMETERS, spécifiant les paramètres d’appel pour l’appel entrant.

Valeur de retour

None

Remarques

Si la fonction ProtocolClIncomingCall d’un client retourne NDIS_STATUS_PENDING pour un appel proposé entrant sur un SAP particulier, précédemment inscrit par le client auprès de NdisClRegisterSap, le client doit ensuite appeler NdisClIncomingCallComplete pour indiquer s’il accepte ou rejette l’appel proposé.

Avant d’appeler NdisClIncomingCallComplete, un tel client peut négocier avec le gestionnaire d’appels en appelant NdisClModifyCallQoS une ou plusieurs fois jusqu’à ce que les deux pilotes parviennent à un accord sur une qualité de service acceptable pour l’appel entrant ou que le client décide qu’il doit rejeter l’appel proposé, car ses tentatives de modification de la QoS atteignent une limite déterminée par le client sans aboutir à un accord.

Si le client a modifié les paramètres d’appel passés à sa fonction ProtocolClIncomingCall , il doit définir le membre Flags dans la structure CO_CALL_PARAMETERS avec CALL_PARAMETERS_CHANGED lorsqu’il transmet ces modifications à NdisClIncomingCallComplete. Selon que le gestionnaire d’appels accepte ou rejette les modifications proposées par le client aux paramètres d’appel, NDIS appelle par la suite l’un ou l’autre des paramètres d’appel du client. Fonction ProtocolClCallConnected ou son Fonction ProtocolClIncomingCloseCall , respectivement.

Un appel à NdisClIncomingCallComplete amène NDIS à appeler le cm Fonction ProtocolCmIncomingCallComplete . NDIS transmet les paramètres fournis par le client de NdisClIncomingCallComplete en tant que paramètres d’entrée à ProtocolCmIncomingCallComplete.

Si un client rejette un appel proposé en affectant à Status une valeur autre que NDIS_STATUS_SUCCESS, le client doit considérer le pointeur CallParameters non valide dès que son appel à NdisClIncomingCallComplete se produit.

Configuration requise

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