NdisMCmAddPartyComplete-Makro (ndis.h)

Artikel
02/07/2025

NdisMCmAddPartyComplete den endgültigen Status der Anforderung eines Clients zurück, für die der MCM-Treiber zuvor NDIS_STATUS_PENDING zurückgegeben hat, um eine Partei zu einem etablierten Multipoint VC hinzuzufügen.

Syntax

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

Parameter

_S_

Gibt den endgültigen Status des ADD-Party-Vorgangs des MCM-Treibers an, entweder NDIS_STATUS_SUCCESS oder eine beliebige NDIS_STATUS_XXX-außer NDIS_STATUS_PENDING.

_H_

Gibt den Handle an, der die Partei identifiziert. Der MCM-Treiber hat dieses Handle als Eingabeparameter für seine ProtocolCmAddParty--Funktion abgerufen.

_C_

Gibt das Handle für einen vom Anrufer zugewiesenen residenten Kontextbereich an, in dem der MCM-Treiber parteispezifische Statusinformationen verwaltet, wenn der Add-Party-Vorgang erfolgreich war. Andernfalls kann dieser Parameter NULL- werden, da er von NDIS ignoriert wird, wenn Status- etwas anderes als NDIS_STATUS_SUCCESS ist.

_P_

Zeiger auf eine Struktur vom Typ CO_CALL_PARAMETERS, die die Aufrufparameter enthält, die ursprünglich vom Client bereitgestellt wurden, damit der Anbieter hinzugefügt werden kann.

Rückgabewert

Nichts

Bemerkungen

Wenn die ProtocolCmAddParty-Funktion eines MCM-Treibers NDIS_STATUS_PENDING zurückgegeben wird, muss der Treiber NdisMCmAddPartyComplete anschließend aufrufen, um den Client und NDIS darüber zu benachrichtigen, dass der Versuch, einen Party auf dem Multipoint VC hinzuzufügen, erfolgreich oder mit einem MCM-Treiber-ermittelten Fehlerstatus abgeschlossen wurde.

Das zugrunde liegende Netzwerkmedium bestimmt, ob ein Client Pro-Party-Datenverkehrsparameter für eine Multipoint-VC angeben kann.

Wenn das zugrunde liegende Netzwerkmedium die Datenverkehrsparameter pro Partei auf Multipoint-VCs nicht unterstützt, kann ein MCM-Treiber eine der folgenden Aktionen ausführen, wenn ein Client versucht, eine Partei mit einer Spezifikation unter CallParameters hinzuzufügen, die nicht mit den bereits festgelegten Datenverkehrsparametern für diese VC übereinstimmen:

Setzen Sie die Datenverkehrsparameter auf diejenigen zurück, die bereits für den Multipoint VC eingerichtet wurden, wenn sie die Partei erfolgreich zu diesem VC hinzufügt.
Ändern Sie die Datenverkehrsparameter für jede Partei, die bereits auf dem VC vorhanden ist, wenn sie die neue Partei erfolgreich hinzufügt.
Ablehnen der Anforderung zum Hinzufügen einer neuen Partei. (Diese Alternative zwingt Clients implizit, ihre Datenverkehrsparameter für eine Multipoint-VC mit NdisClMakeCall- einzurichten und die gleichen Datenverkehrsparameter bei jedem nachfolgenden Aufruf von NdisClAddParty- für den angegebenen Multipoint VC anzugeben.)

Wenn der MCM-Treiber Status auf NDIS_STATUS_SUCCESS festlegt, muss er einen expliziten Handle bereitstellen, der in der Regel ein Zeiger auf den vom Treiber zugewiesenen Statusbereich ist, wie CallMgrPartyContext, wenn er NdisMCmAddPartyCompleteaufruft.

Ein Aufruf von NdisMCmAddPartyComplete bewirkt, dass NDIS den Client aufruft ProtocolClAddPartyComplete-Funktion.

Nur verbindungsorientierte Miniporttreiber, die integrierte Anrufverwaltungsunterstützung bieten, können NdisMCmAddPartyCompleteanrufen. Eigenständige Anrufmanager, die sich selbst bei NDIS als Protokolltreiber registrieren, rufen sie stattdessen NdisCmAddPartyComplete auf.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisMCmAddPartyComplete (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisMCmAddPartyComplete (NDIS 5.1)) in Windows XP.
Zielplattform-	Desktop
Header-	ndis.h (include Ndis.h)
IRQL-	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_MCM_Function(ndis)