Dodawanie uczestnika do rozmowy wielopunktowej

Klient prosi o dodanie uczestnika do wywołania wielopunktowego za pomocą NdisClAddParty. Klient może dodać jednostkę tylko do istniejącego wywołania multipoint — czyli wywołania, dla którego klient dostarczył element ProtocolPartyContextndisClMakeCall (zobacz Tworzenie wywołania).

Na poniższej ilustracji przedstawiono klienta menedżera połączeń żądającego dodania uczestnika do wywołania wielopunktowego.

Na poniższym rysunku przedstawiono klienta sterownika MCM żądającego dodania uczestnika do wywołania wielopunktowego.

Przed wywołaniem NdisClAddParty klient musi przydzielić i zainicjować swój obszar kontekstu, aby partia została dodana. Klienci często przekazują wskaźnik do takiego obszaru kontekstu jak ProtocolPartyContext i wskaźnik do zmiennej w tym obszarze kontekstu jako parametry NdisPartyHandle podczas wywoływania NdisClAddPartyParty.

Oprócz NdisVcHandle i ProtocolPartyContext klient przekazuje parametry wywołania (buforowane CO_CALL_PARAMETERS struktury) do NdisClAddParty. Podstawowy nośnik sieciowy określa, czy klient może określić parametry ruchu dla każdego użytkownika na wirtualnym kanale multipunktowym (VC).

Wywołanie NdisClAddParty powoduje, że NDIS przekazuje to żądanie do funkcji ProtocolCmAddParty menedżera wywołań lub sterownika MCM, z którym klient dzieli dany NdisVcHandle. Usługa NDIS przekazuje poniższe informacje do ProtocolCmAddParty:

• Obiekt CallMgrVcContext wskazujący VC dla wywołania.

• Wskaźnik do struktury CO_CALL_PARAMETERS, która zawiera parametry wywołania przekazywane przez klienta do NdisClAddParty.

• NdisPartyHandle, który identyfikuje stronę do dodania.

ProtocolCmAddParty przydziela i inicjuje wszelkie zasoby dynamiczne potrzebne do dodania jednostki do wywołania. W ramach ProtocolCmAddParty, menedżer wywołań lub sterownik MCM komunikuje się z urządzeniami sterowania siecią lub innymi agentami specyficznymi dla nośnika, w razie potrzeby, aby dodać określoną stronę do połączenia wielopunktowego.

Jeśli klient przekazał parametry wywołania, które nie pasują do już ustanowionych dla wielopunktowego VC, menedżer wywołań lub sterownik MCM może np.:

• Skonfiguruj parametry ruchu dla poszczególnych uczestników, jeśli bazowe medium sieciowe obsługuje tę funkcję na wielopunktowych obwodach wirtualnych.

• Zresetuj parametry ruchu dostarczone przez klienta do tych pierwotnie ustanowionych dla VC.

• Zmień parametry wywołania dla VC i dla każdego uczestnika, który jest aktualnie połączony.

• Zablokuj próbę dodania strony przez klienta.

ProtocolCmAddParty może zakończyć się synchronicznie lub, najprawdopodobniej, asynchronicznie z NdisCmAddPartyComplete, w przypadku menedżera wywołań, lub NdisMCmAddPartyComplete, w przypadku sterownika MCM. Niezależnie od tego, czy menedżer wywołań, czy sterownik MCM wykonuje operację synchronicznie, czy asynchronicznie, przekazuje buforowane parametry wywołania do sieci NDIS.

Wywołanie Ndis(M)CmAddPartyComplete powoduje, że NDIS wywołuje funkcję ProtocolClAddPartyComplete klienta. Jeśli żądanie klienta dodania jednostki powiodło się i jeśli protokół sygnalizacyjny zezwala menedżerowi wywołań lub sterownikowi MCM na modyfikowanie parametrów wywołania, ProtokółClAddPartyComplete powinien przetestować flagę CALL_PARAMETERS_CHANGED w buforowanej strukturze CO_CALL_PARAMETERS w celu ustalenia, czy parametry wywołania zostały zmodyfikowane. Protokół sygnalizacyjny określa, co klient może zrobić, jeśli znajdzie modyfikacje CO_CALL_PARAMETERS niedopuszczalne. Zazwyczaj klient wykonuje NdisClDropParty w tym przypadku (zobacz Usuwanie uczestnika z rozmowy typu multipoint).