NdisCmAddPartyComplete, fonction (ndis.h)
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é.)
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) |