Macro NdisMCmAddPartyComplete (ndis.h)

Article
08/07/2023

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

Syntaxe

void NdisMCmAddPartyComplete(
   _S_,
   _H_,
   _C_,
   _P_
);

Paramètres

_S_

Spécifie la status finale de l’opération complémentaire du pilote MCM, soit NDIS_STATUS_SUCCESS, soit tout NDIS_STATUS_XXX, sauf NDIS_STATUS_PENDING.

_H_

Spécifie le handle identifiant le tiers. Le pilote MCM a obtenu ce handle en tant que paramètre d’entrée pour sa fonction ProtocolCmAddParty .

_C_

Spécifie le handle d’une zone de contexte résident allouée à l’appelant dans laquelle le pilote MCM conservera les informations d’état spécifiques au tiers si l’opération de l’add-party a réussi. Sinon, ce paramètre peut être NULL , car il est ignoré par NDIS si Status est autre que NDIS_STATUS_SUCCESS.

_P_

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 pilote MCM retourne NDIS_STATUS_PENDING, le pilote doit appeler NdisMCmAddPartyComplete par la suite pour informer le client et NDIS que sa tentative d’ajout d’une partie sur le vc multipoint est terminée, que ce soit avec succès ou avec une erreur déterminée par le pilote MCM status.

Le support réseau sous-jacent détermine si un client peut spécifier des paramètres de trafic par partie sur un vc multipoint.

Si le support réseau sous-jacent ne prend pas en charge les paramètres de trafic par partie sur les machines virtuelles multipoints, un pilote MCM peut effectuer l’une des opérations suivantes lorsqu’un client tente d’ajouter une partie avec une spécification sur CallParameters qui ne correspond pas aux paramètres de trafic déjà établis pour ce vc :

Réinitialisez les paramètres de trafic sur ceux déjà établis pour le vc multipoint lorsqu’il ajoute correctement la partie sur ce vc.
Modifiez les paramètres de trafic pour chaque partie déjà présente sur le vc lorsqu’il a correctement ajouté la nouvelle partie.
Rejeter la demande d’ajout d’une nouvelle partie. (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 pilote MCM 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 le pilote, comme CallMgrPartyContext quand il appelle NdisMCmAddPartyComplete.

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

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisMCmAddPartyComplete (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisMCmAddPartyComplete (NDIS 5.1)) dans Windows XP.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	ndis.h (inclure Ndis.h)
IRQL	<= DISPATCH_LEVEL
Règles de conformité DDI	Irql_MCM_Function(ndis)