PROTOCOL_CL_INCOMING_CALL fonction de rappel (ndis.h)

Article
08/07/2023

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

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

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 que le client a fourni à l’origine lors de l’inscription du SAP, que le gestionnaire d’appels a mis en correspondance avec cette offre d’appel entrante.

[in] ProtocolVcContext

Spécifie le handle dans 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 offert.

Valeur retournée

ProtocolClIncomingCall peut retourner l’un des codes status suivants :

Code de retour	Description
NDIS_STATUS_SUCCESS	Le client a accepté l’offre d’appel entrante.
NDIS_STATUS_PENDING	Le client gère cette demande de manière asynchrone, et il 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 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.

En fonction du protocole de signalisation pris en charge par le gestionnaire d’appels, ProtocolClIncomingCall peut 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 spécification de qualité de service sur CallParameters . Le client doit copier toutes les informations dont il aura besoin par la suite à partir de cette structure mise en mémoire tampon s’il 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 des transferts se produisent sur le VC actif représentant la connexion au client sur le nœud distant à l’origine de l’offre d’appel. Si le client retourne des paramètres d’appel modifiés qui ne sont pas acceptables, le gestionnaire d’appels peut détruire le vc qu’il a créé pour cette offre, ce qui entraîne des appels vers le client. ProtocolClIncomingCloseCall , puis ProtocolCoDeleteVc fonctionnent à la place.

Exemples

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 fonction permet à l’analyse du code pour les pilotes, le vérificateur de pilotes statique (SDV) et d’autres outils de vérification de trouver les erreurs, et il s’agit d’une exigence pour l’écriture de 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 lors de l’exécution des 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 Annotating Function Behavior.

Configuration requise

Condition requise	Valeur
Client minimal 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 (consultez ProtocolClIncomingCall (NDIS 5.1)) dans Windows XP.
Plateforme cible	Windows
En-tête	ndis.h (inclure Ndis.h)
IRQL	<= DISPATCH_LEVEL