Macro NdisMCmDispatchIncomingCall (ndis.h)

Article
02/07/2025

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 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 pour son ProtocolCmRegisterSap fonction.

_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 la vc.

Valeur de retour

Aucun

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 d’établir une 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é la 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, dans laquelle le client accepte ou rejette la connexion demandée. Après avoir décidé s’il faut accepter la connexion, le client appelle NdisClIncomingCallComplete, ce 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-être supprime) 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 un appel de prise en charge intégrée de la gestion des appels NdisMCmDispatchIncomingCall. Les gestionnaires d’appels autonomes, qui s’inscrivent auprès de NDIS comme pilotes de protocole, appellent NdisCmDispatchIncomingCall à la place.

Exigences

Exigence	Valeur
client minimum 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 (voir NdisMCmDispatchIncomingCall (NDIS 5.1)) dans Windows XP.
plateforme cible	Bureau
d’en-tête	ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL
règles de conformité DDI	Irql_MCM_Function(ndis)