Een partij toevoegen aan een multipoint-aanroep

Een client vraagt om een partij toe te voegen aan een multipoint-aanroep met NdisClAddParty-. Een client kan alleen een partij toevoegen aan een bestaande multipoint-aanroep, dat wil gezegd: een aanroep waarvoor de client een ProtocolPartyContext- heeft verstrekt aan NdisClMakeCall-(zie Een oproepmaken).

In de volgende afbeelding ziet u een client van een oproepmanager die vraagt om een partij toe te voegen aan een multipoint gesprek.

In de volgende afbeelding wordt een client van een MCM-stuurprogramma getoond die een partij wil toevoegen aan een multipoint conference call.

Voordat NdisClAddParty-wordt aangeroepen, moet een client zijn contextgebied toewijzen en initialiseren waarbij de partij moet worden toegevoegd. Clients geven vaak een aanwijzer door aan een dergelijk contextgebied als de ProtocolPartyContext en een aanwijzer naar een variabele binnen dat contextgebied als de NdisPartyHandle- parameters wanneer ze NdisClAddParty-aanroepen.

Naast een NdisVcHandle- en een ProtocolPartyContext-, geeft de client aanroepparameters (een gebufferde CO_CALL_PARAMETERS structuur) door aan NdisClAddParty-. Het onderliggende netwerkmedium bepaalt of een client verkeersparameters per partij kan opgeven op een VC met meerdere locaties.

De aanroep naar NdisClAddParty zorgt ervoor dat NDIS dit verzoek doorstuurt naar de ProtocolCmAddParty functie van de oproepmanager of het MCM-stuurprogramma waarmee de cliënt de opgegeven NdisVcHandle deelt. NDIS geeft het volgende door aan de ProtocolCmAddParty:

• Een CallMgrVcContext die de VC voor de oproep aangeeft.

• Een aanwijzer naar een CO_CALL_PARAMETERS structuur die de aanroepparameters bevat die de client doorgeeft aan NdisClAddParty-.

• Een NdisPartyHandle- waarmee de toe te voegen partij wordt geïdentificeerd.

ProtocolCmAddParty wijst dynamische resources toe en initialiseert die nodig zijn voor de partij die aan de oproep wordt toegevoegd. Vanuit ProtocolCmAddParty-communiceert een oproepbeheer- of MCM-stuurprogramma indien nodig met netwerkbeheerapparaten of andere mediaspecifieke agents om de opgegeven partij toe te voegen aan de multipoint-aanroep.

Als de client aanroepparameters heeft doorgegeven die niet overeenkomen met de parameters die al zijn ingesteld voor de multipoint VC, kan het gespreksbeheer- of MCM-stuurprogramma bijvoorbeeld:

• Stel de verkeersparameters per partij in als het onderliggende netwerkmedium deze functie ondersteunt op multipoint-VM's.

• Stel de door de client geleverde verkeersparameters opnieuw in op de parameters die oorspronkelijk zijn ingesteld voor de VC.

• Wijzig de oproepparameters voor de VC en voor elke partij die erop is aangesloten.

• Faal de poging van de cliënt om een partij toe te voegen.

ProtocolCmAddParty- kan synchroon of, waarschijnlijker, asynchroon worden voltooid met NdisCmAddPartyComplete, in het geval van een oproepbeheerder of NdisMCmAddPartyComplete, in het geval van een MCM-stuurprogramma. Of het gespreksbeheer- of MCM-stuurprogramma de bewerking synchroon of asynchroon voltooit, het geeft de aanroepparameters in de buffer door aan NDIS.

De aanroep van Ndis(M)CmAddPartyComplete zorgt ervoor dat NDIS de functie ProtocolClAddPartyComplete van de client aanroept. Als de aanvraag van de client om de partij toe te voegen is geslaagd en als het signaleringsprotocol de aanroepmanager of het MCM-stuurprogramma toestaat de oproepparameters te wijzigen, moet ProtocolClAddPartyComplete- de CALL_PARAMETERS_CHANGED vlag testen in de gebufferde CO_CALL_PARAMETERS structuur om te bepalen of de oproepparameters zijn gewijzigd. Het signaleringsprotocol bepaalt wat de client kan doen als de wijzigingen in CO_CALL_PARAMETERS onaanvaardbaar zijn. Meestal doet een klant in dit geval een oproep naar NdisClDropParty (zie Een partij verwijderen van een multipoint-oproep).