Macro NdisMCmDispatchIncomingCall (ndis.h)

Article
02/26/2024

NdisMCmDispatchIncomingCall informe le client d’un appel entrant sur un sap précédemment inscrit par ce client auprès du pilote MCM.

Syntaxe

void NdisMCmDispatchIncomingCall(
   _SH_,
   _VH_,
   _CP_
);

Paramètres

_SH_

Spécifie le handle identifiant le SAP. NDIS configure ce handle lorsque le client a initialement appelé NdisClRegisterSap, et que le pilote MCM a obtenu ce handle en tant que paramètre d’entrée de son Fonction ProtocolCmRegisterSap .

_VH_

Spécifie le handle identifiant le VC, créé avec NdisMCmCreateVc lorsque le pilote MCM traite l’offre d’appel entrante dirigée vers ce SAP inscrit.

_CP_

Pointeur vers une structure de type CO_CALL_PARAMETERS qui spécifie les paramètres d’appel et de média pour le vc.

Valeur de retour

None

Remarques

Avant d’appeler NdisMCmDispatchIncomingCall, un pilote MCM a déjà effectué les opérations suivantes :

Identifié le SAP cible, précédemment inscrit par un client particulier, pour l’appel (en fait, une demande de connexion) qu’il a reçu sur le réseau
Création d’un vc pour l’appel entrant avec NdisMCmCreateVc
Éventuellement négocié sur les paramètres d’appel acceptables sur le réseau, ou accepté les paramètres d’appel envoyés à partir du nœud distant
Activé le VC avec NdisMCmActivateVc pour informer NDIS qu’il est prêt pour les transferts sur le VC en accord avec les paramètres d’appel négociés ou acceptés

L’appel du pilote MCM à NdisMCmDispatchIncomingCall amène NDIS à appeler la fonction ProtocolClIncomingCall du client, au sein de laquelle le client accepte ou rejette la connexion demandée. Après avoir décidé d’accepter la connexion, le client appelle NdisClIncomingCallComplete, qui, à son tour, appelle la fonction ProtocolCmIncomingCallComplete du pilote MCM. Si le client a accepté l’appel, le pilote MCM appelle ensuite NdisMCmDispatchCallConnected. Sinon, il désactive (et peut éventuellement supprimer) le vc qu’il a créé, après avoir averti le nœud distant que l’appel proposé a été rejeté.

Seuls les pilotes miniport orientés connexion qui fournissent une gestion intégrée des appels prennent en charge L’appel NdisMCmDispatchIncomingCall. Les gestionnaires d’appels autonomes, qui s’inscrivent auprès de NDIS en tant que pilotes de protocole, appellent NdisCmDispatchIncomingCall à la place.

Configuration requise

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