Fonction NdisCmDispatchIncomingCall (ndis.h)

Article
02/26/2024

NdisCmDispatchIncomingCall informe le client d’un appel entrant sur un SAP précédemment inscrit par ce client.

Syntaxe

NDIS_STATUS NdisCmDispatchIncomingCall(
  [in] NDIS_HANDLE         NdisSapHandle,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Paramètres

[in] NdisSapHandle

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

[in] NdisVcHandle

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

[in] CallParameters

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

Valeur retournée

Lorsque NdisCmDispatchIncomingCall retourne autre chose que NDIS_STATUS_PENDING, le gestionnaire d’appels doit effectuer un appel interne à son Fonction ProtocolCmIncomingCallComplete . Sinon, NDIS appelle la fonction ProtocolCmIncomingCallComplete du CM lorsque cette opération est terminée.

Remarques

Avant d’appeler NdisCmDispatchIncomingCall, un gestionnaire d’appels autonome 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 NdisCoCreateVc
É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 NdisCmActivateVc, ce qui a entraîné le pilote miniport sous-jacent à se préparer pour les transferts sur le VC en accord avec les paramètres d’appel négociés ou acceptés

L’appel du CM à NdisCmDispatchIncomingCall 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 le cm Fonction ProtocolCmIncomingCallComplete . Si le client a accepté l’appel, le CM appelle ensuite NdisCmDispatchCallConnected. 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 gestionnaires d’appels autonomes, qui s’inscrivent auprès de NDIS en tant que pilotes de protocole, peuvent appeler NdisCmDispatchIncomingCall. Les pilotes miniport orientés connexion qui fournissent une prise en charge intégrée de la gestion des appels appellent plutôt NdisMCmDispatchIncomingCall .

Configuration requise

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