NdisCmAddPartyComplete, fonction (ndis.h)

Article
02/26/2024

NdisCmAddPartyComplete retourne la status finale de la demande d’un client, pour laquelle le gestionnaire d’appels a précédemment renvoyé NDIS_STATUS_PENDING, pour ajouter une partie sur un vc multipoint établi.

Syntaxe

void NdisCmAddPartyComplete(
  [in]           NDIS_STATUS         Status,
  [in]           NDIS_HANDLE         NdisPartyHandle,
  [in, optional] NDIS_HANDLE         CallMgrPartyContext,
  [in]           PCO_CALL_PARAMETERS CallParameters
);

Paramètres

[in] Status

Spécifie la status finale de l’opération complémentaire du gestionnaire d’appels, soit NDIS_STATUS_SUCCESS, soit n’importe quel NDIS_STATUS_XXX, sauf NDIS_STATUS_PENDING.

[in] NdisPartyHandle

Spécifie le handle identifiant le tiers. Ce handle a été entré dans la fonction ProtocolCmAddParty du gestionnaire d’appels.

[in, optional] CallMgrPartyContext

Spécifie le handle d’une zone de contexte résident allouée à l’appelant dans laquelle le gestionnaire d’appels conservera les informations d’état spécifiques à un tiers si l’opération de tiers a réussi. Sinon, ce paramètre peut être NULL , car il est ignoré.

[in] CallParameters

Pointeur vers une structure de type CO_CALL_PARAMETERS qui contient les paramètres d’appel, fournis à l’origine par le client, pour le tiers à ajouter.

Valeur de retour

None

Remarques

Si la fonction ProtocolCmAddParty d’un gestionnaire d’appels autonome retourne NDIS_STATUS_PENDING, le cm doit ensuite appeler NdisCmAddPartyComplete pour informer le client et NDIS que sa tentative d’ajout d’une partie sur le vc multipoint s’est terminée, que ce soit avec succès ou avec une erreur.

Si le client a transmis à CallParameters des paramètres de trafic qui ne correspondent pas à ceux déjà établis pour le vc multipoint, le concepteur du gestionnaire d’appels doit déterminer comment gérer cette condition, sous réserve des contraintes imposées par le support réseau. Il existe plusieurs types d'erreurs possibles dont notamment :

Configurez les paramètres de trafic par partie si le support réseau sous-jacent prend en charge cette fonctionnalité sur les machines virtuelles multipoints.
Réinitialisez les paramètres de trafic fournis par le client à ceux établis pour le vc lorsque l’appel sortant d’origine a été effectué avant que le cm n’appelle NdisCmAddPartyComplete avec NDIS_STATUS_SUCCESS comme État .
Modifiez les paramètres de trafic pour le vc et, pour chaque partie actuellement connectée sur celui-ci, sur les valeurs fournies par le client avant que le cm appelle NdisCmAddPartyComplete avec NDIS_STATUS_SUCCESS comme État .
Échec de la tentative d’ajout d’un tiers par le client. (Cette alternative force implicitement les clients à configurer leurs paramètres de trafic pour un vc multipoint avec NdisClMakeCall et à spécifier les mêmes paramètres de trafic à chaque appel ultérieur à NdisClAddParty pour le vc multipoint donné.)

Pour certains médias orientés connexion , les paramètres de trafic sont par nature par vc et, par conséquent, identiques pour toutes les parties sur un vc multipoint.

Si le cm définit Status sur NDIS_STATUS_SUCCESS, il doit fournir un handle explicite, qui est généralement un pointeur vers la zone d’état par partie allouée par cm, en tant que CallMgrPartyContext lorsqu’il appelle NdisCmAddPartyComplete.

Un appel à NdisCmAddPartyComplete amène NDIS à appeler le client Fonction ProtocolClAddPartyComplete .

Seuls les gestionnaires d’appels autonomes, qui s’inscrivent eux-mêmes auprès de NDIS en tant que pilotes de protocole, peuvent appeler NdisCmAddPartyComplete. Les pilotes miniport orientés connexion qui fournissent une prise en charge intégrée de la gestion des appels appellent À la place NdisMCmAddPartyComplete .

Configuration requise

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