Hinzufügen einer Partei zu einem Mehrpunktaufruf

Ein Client fordert das Hinzufügen einer Partei zu einem Mehrpunktaufruf mit NdisClAddParty an. Ein Client kann eine Partei nur zu einem vorhandenen mehrpunktigen Aufruf hinzufügen, d.a. einem Aufruf, für den der Client einen ProtocolPartyContext an NdisClMakeCall bereitgestellt hat (siehe Tätigen eines Anrufs).

Die folgende Abbildung zeigt einen Client eines Anruf-Managers, der anfordert, eine Partei zu einem Mehrpunktanruf hinzuzufügen.

Die folgende Abbildung zeigt einen Client eines MCM-Treibers, der anfordert, eine Partei zum Mehrpunktaufruf hinzuzufügen.

Bevor NdisClAddParty aufgerufen wird, muss ein Client seinen Kontextbereich zuordnen und initialisieren, damit die Partei hinzugefügt wird. Clients übergeben in der Regel einen Zeiger auf einen Kontextbereich wie protocolPartyContext und einen Zeiger auf eine Variable innerhalb dieses Kontextbereichs als NdisPartyHandle-Parameter , wenn sie NdisClAddParty aufrufen.

Zusätzlich zu einem NdisVcHandle und einem ProtocolPartyContext übergibt der Client Aufrufparameter (eine gepufferte CO_CALL_PARAMETERS-Struktur ) an NdisClAddParty. Das zugrunde liegende Netzwerkmedium bestimmt, ob ein Client Für einen mehrstufigen VC-Datenverkehr parameter pro Partei angeben kann.

Durch den Aufruf von NdisClAddParty leitet NDIS diese Anforderung an die ProtocolCmAddParty-Funktion des Aufruf-Managers oder MCM-Treibers weiter, mit dem der Client die angegebene NdisVcHandle teilt . NDIS übergibt Folgendes an die ProtocolCmAddParty:

• Ein CallMgrVcContext , der die VC für den Anruf angibt.

• Ein Zeiger auf eine CO_CALL_PARAMETERS-Struktur, die die Aufrufparameter enthält, die der Client an NdisClAddParty übergibt.

• Ein NdisPartyHandle , das die hinzuzufügende Partei identifiziert.

ProtocolCmAddParty weist alle dynamischen Ressourcen zu, die für die Dem Aufruf hinzugefügte Partei erforderlich sind, und initialisiert diese. Über ProtocolCmAddParty kommuniziert ein Anruf-Manager oder MCM-Treiber bei Bedarf mit Netzwerksteuerungsgeräten oder anderen medienspezifischen Agents, um die angegebene Partei dem Mehrpunktaufruf hinzuzufügen.

Wenn der Client Aufrufparameter übergeben hat, die nicht mit denen übereinstimmten, die bereits für die Multipoint-VC eingerichtet wurden, kann der Anruf-Manager oder MCM-Treiber z. B.:

• Richten Sie die Datenverkehrsparameter pro Seite ein, wenn das zugrunde liegende Netzwerkmedium dieses Feature auf Mehrpunkt-VCs unterstützt.

• Setzen Sie die vom Client bereitgestellten Datenverkehrsparameter auf die parameter zurück, die ursprünglich für die VC eingerichtet wurden.

• Ändern Sie die Aufrufparameter für die VC und für jede Partei, die derzeit mit ihr verbunden ist.

• Fehler beim Versuch des Clients, eine Partei hinzuzufügen.

ProtocolCmAddParty kann synchron oder wahrscheinlich asynchron mit NdisCmAddPartyComplete abgeschlossen werden, im Fall eines Anruf-Managers oder NdisMCmAddPartyComplete, im Fall eines MCM-Treibers. Unabhängig davon, ob der Anruf-Manager oder der MCM-Treiber den Vorgang synchron oder asynchron abschließt, übergibt er die gepufferten Aufrufparameter an NDIS.

Durch den Aufruf von Ndis(M)CmAddPartyComplete ruft NDIS die ProtocolClAddPartyComplete-Funktion des Clients auf. Wenn die Anforderung des Clients zum Hinzufügen der Partei erfolgreich war und das Signalisierungsprotokoll es dem Anruf-Manager oder MCM-Treiber ermöglicht, die Aufrufparameter zu ändern, sollte ProtocolClAddPartyComplete das CALL_PARAMETERS_CHANGED-Flag in der gepufferten CO_CALL_PARAMETERS-Struktur testen, um festzustellen, ob die Aufrufparameter geändert wurden. Das Signalisierungsprotokoll bestimmt, was der Client tun kann, wenn er die Änderungen an CO_CALL_PARAMETERS inakzeptabel findet. In der Regel ruft ein Client in diesem Fall NdisClDropParty auf (siehe Löschen einer Partei aus einem Mehrpunktaufruf).