Macro NdisMCmAddPartyComplete (ndis.h)
NdisMCmAddPartyComplete retourne l’état final de la demande d’un client, pour laquelle le pilote MCM a précédemment retourné NDIS_STATUS_PENDING, pour ajouter une partie à une vc multipoint établie.
Syntaxe
void NdisMCmAddPartyComplete(
_S_,
_H_,
_C_,
_P_
);
Paramètres
_S_
Spécifie l’état final de l’opération de complément du pilote MCM, NDIS_STATUS_SUCCESS ou n’importe quel NDIS_STATUS_XXXsauf NDIS_STATUS_PENDING.
_H_
Spécifie le handle identifiant la partie. Le pilote MCM a obtenu ce handle en tant que paramètre d’entrée à sa fonction ProtocolCmAddParty.
_C_
Spécifie le handle d’une zone de contexte résident allouée par l’appelant dans laquelle le pilote MCM conserve les informations d’état spécifiques à la partie si l’opération de partie complémentaire a réussi. Sinon, ce paramètre peut être NULL, car il est ignoré par NDIS si Status est autre chose que NDIS_STATUS_SUCCESS.
_P_
Pointeur vers une structure de type CO_CALL_PARAMETERS qui contient les paramètres d’appel, initialement fournis par le client, pour que la partie soit ajoutée.
Valeur de retour
Aucun
Remarques
Si la fonction ProtocolCmAddParty d’un pilote MCM retourne NDIS_STATUS_PENDING, le pilote doit appeler NdisMCmAddPartyComplete par la suite pour avertir le client et NDIS que sa tentative d’ajouter une partie à la vc multipoint s’est terminée, que ce soit avec succès ou avec un état d’erreur déterminé par le pilote MCM.
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 des machines virtuelles multipoints, un pilote MCM peut effectuer l’une des opérations suivantes chaque fois qu’un client tente d’ajouter une partie avec une spécification à CallParameters qui ne correspond pas aux paramètres de trafic déjà établis pour cette vc :
- Réinitialisez les paramètres de trafic sur ceux déjà établis pour la vc multipoint lorsqu’il ajoute la partie à cette vc.
- Modifiez les paramètres de trafic pour chaque partie déjà sur la vc lorsqu’elle ajoute correctement la nouvelle partie.
- Refusez la demande d’ajout d’une nouvelle partie. (Cela oblige implicitement les clients à configurer leurs paramètres de trafic pour une vc multipoint avec NdisClMakeCall et à spécifier les mêmes paramètres de trafic à chaque appel suivant à NdisClAddParty pour le vc multipoint donné.)
Un appel à NdisMCmAddPartyComplete entraîne l’appel de NDIS au client ProtocolClAddPartyComplete fonction.
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 auprès de NDIS en tant que pilotes de protocole, appellent NdisCmAddPartyComplete à la place.