Macro NdisMCmDispatchIncomingCall (ndis.h)

NdisMCmDispatchIncomingCall informe le client d’un appel entrant sur un SAP précédemment inscrit par ce client avec le 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 le pilote MCM a obtenu ce handle en tant que paramètre d’entrée à 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 pour é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é 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 provoque l’appel de 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-ê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 support intégré de gestion des appels appel NdisMCmDispatchIncomingCall. Les gestionnaires d’appels autonomes, qui s’inscrivent auprès de NDIS comme pilotes de protocole, appellent NdisCmDispatchIncomingCall à la place.

Configuration requise

   
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 (voir NdisMCmDispatchIncomingCall (NDIS 5.1)) dans Windows XP.
Plateforme cible Desktop (Expérience utilisateur)
En-tête ndis.h (include Ndis.h)
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI Irql_MCM_Function(ndis)

Voir aussi

CO_CALL_PARAMETERS

MiniportInterruptDPC

NdisClIncomingCallComplete

NdisClRegisterSap

NdisCmDispatchIncomingCall

NdisMCmActivateVc

NdisMCmCreateVc

NdisMCmDeactivateVc

NdisMCmDeleteVc

NdisMCmDispatchCallConnected

ProtocolClIncomingCall

ProtocolCmIncomingCallComplete

ProtocolCmRegisterSap