PROTOCOL_CL_INCOMING_CALL fonction de rappel (ndis.h)

Article
02/07/2025

La fonction ProtocolClIncomingCall est utilisée par les clients orientés connexion qui acceptent les appels entrants. Ces clients doivent disposer de fonctions ProtocolClIncomingCall. Sinon, la fonction ProtocolClIncomingCall inscrite d’un pilote de protocole peut simplement retourner NDIS_STATUS_NOT_SUPPORTED.

Remarque Vous devez déclarer la fonction à l’aide du type PROTOCOL_CL_INCOMING_CALL. Pour plus d’informations, consultez la section Exemples suivants.

Syntaxe

PROTOCOL_CL_INCOMING_CALL ProtocolClIncomingCall;

NDIS_STATUS ProtocolClIncomingCall(
  [in]      NDIS_HANDLE ProtocolSapContext,
  [in]      NDIS_HANDLE ProtocolVcContext,
  [in, out] PCO_CALL_PARAMETERS CallParameters
)
{...}

Paramètres

[in] ProtocolSapContext

Spécifie le handle fourni à l’origine par le client lors de l’inscription de SAP, que le gestionnaire d’appels a mis en correspondance avec cette offre d’appel entrante.

[in] ProtocolVcContext

Spécifie le handle de la zone de contexte par VC du client, précédemment retourné à NDIS par sa fonction ProtocolCoCreateVc.

[in, out] CallParameters

Pointeur vers une mémoire tampon, mise en forme en tant que structure CO_CALL_PARAMETERS, qui contient les paramètres d’appel pour cet appel proposé.

Valeur de retour

ProtocolClIncomingCall peut retourner l’un des codes d’état suivants :

Retourner le code	Description
NDIS_STATUS_SUCCESS	Le client a accepté l’offre d’appel entrante.
NDIS_STATUS_PENDING	Le client gère cette requête de façon asynchrone et appellera le fonction NdisClIncomingCallComplete lorsque l’opération de fermeture est terminée.
NDIS_STATUS_XXX	Le client a rejeté l’offre d’appel entrante pour une raison déterminée par le pilote.

Remarques

Un appel à ProtocolClIncomingCall indique que le gestionnaire d’appels a reçu une demande sur le réseau à partir d’un homologue de signalisation pour établir une connexion avec ce client. Autrement dit, la demande de configuration d’une telle connexion a été dirigée vers un SAP précédemment inscrit auprès du gestionnaire d’appels par ce client.

Selon le protocole de signalisation pris en charge par le gestionnaire d’appels, ProtocolClIncomingCall pouvez modifier les paramètres de trafic dans le cadre du processus de négociation de l’acceptation d’une offre d’appel entrante et/ou, si le gestionnaire d’appels prend en charge QoS, la qualité de service à CallParameters. Le client doit copier toutes les informations dont il a besoin par la suite à partir de cette structure mise en mémoire tampon si elle accepte l’appel proposé.

En supposant que le gestionnaire d’appels trouve les modifications du client, le cas échéant, acceptables, NDIS appelle ensuite la fonction ProtocolClIncomingCallConnected du client lorsqu’il devient possible que les transferts se produisent sur la vc active représentant la connexion au client sur le nœud distant qui a initialement lancé l’offre d’appel. Si le client retourne des paramètres d’appel modifiés qui sont inacceptables, le gestionnaire d’appels peut supprimer le vc qu’il a créé pour cette offre, provoquant ainsi des appels au client ProtocolClIncomingCloseCall, puis fonctions ProtocolCoDeleteVc à la place.

exemples de

Pour définir une fonction ProtocolClIncomingCall, vous devez d’abord fournir une déclaration de fonction qui identifie le type de fonction que vous définissez. Windows fournit un ensemble de types de fonctions pour les pilotes. La déclaration d’une fonction à l’aide des types de fonctions permet d'Analyse du code pour les pilotes, de vérificateur de pilotes statiques (SDV) et d’autres outils de vérification recherchent des erreurs, et il est nécessaire d’écrire des pilotes pour le système d’exploitation Windows.

Par exemple, pour définir une fonction ProtocolClIncomingCall nommée « MyClIncomingCall », utilisez le type PROTOCOL_CL_INCOMING_CALL comme indiqué dans cet exemple de code :

PROTOCOL_CL_INCOMING_CALL MyClIncomingCall;

Ensuite, implémentez votre fonction comme suit :

_Use_decl_annotations_
NDIS_STATUS
 MyClIncomingCall(
    NDIS_HANDLE  ProtocolSapContext,
    NDIS_HANDLE  ProtocolVcContext,
    PCO_CALL_PARAMETERS  CallParameters
    )
  {...}

Le type de fonction PROTOCOL_CL_INCOMING_CALL est défini dans le fichier d’en-tête Ndis.h. Pour identifier plus précisément les erreurs lorsque vous exécutez les outils d’analyse du code, veillez à ajouter l’annotation Use_decl_annotations à votre définition de fonction. L’annotation Use_decl_annotations garantit que les annotations appliquées au type de fonction PROTOCOL_CL_INCOMING_CALL dans le fichier d’en-tête sont utilisées. Pour plus d’informations sur la configuration requise pour les déclarations de fonction, consultez Déclaration de fonctions à l’aide de types de rôles de fonction pour les pilotes NDIS.

Pour plus d’informations sur Use_decl_annotations, consultez annoter le comportement de la fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir ProtocolClIncomingCall (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir ProtocolClIncomingCall (NDIS 5.1)) dans Windows XP.
plateforme cible	Windows
d’en-tête	ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL