NdisMCmAddPartyComplete-Makro (ndis.h)

Artikel
08/07/2023

NdisMCmAddPartyComplete gibt die letzte status der Anforderung eines Clients zurück, für die der MCM-Treiber zuvor NDIS_STATUS_PENDING zurückgegeben hat, um eine Partei zu einer festgelegten Multipoint-VC hinzuzufügen.

Syntax

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

Parameter

_S_

Gibt die endgültige status des Add-Party-Vorgangs des MCM-Treibers an, entweder NDIS_STATUS_SUCCESS oder NDIS_STATUS_XXXaußer NDIS_STATUS_PENDING.

_H_

Gibt das Handle an, das 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 Aufrufer zugewiesenen residenten Kontextbereich an, in dem der MCM-Treiber parteispezifische Zustandsinformationen verwaltet, wenn der Add-Party-Vorgang erfolgreich war. Andernfalls kann dieser Parameter NULL sein, da er von NDIS ignoriert wird, wenn Status nicht NDIS_STATUS_SUCCESS ist.

_P_

Zeiger auf eine Struktur vom Typ CO_CALL_PARAMETERS , die die Aufrufparameter enthält, die ursprünglich vom Client für die hinzuzufügende Partei bereitgestellt wurden.

Rückgabewert

Keine

Bemerkungen

Wenn die ProtocolCmAddParty-Funktion eines MCM-Treibers NDIS_STATUS_PENDING zurückgibt, muss der Treiber anschließend NdisMCmAddPartyComplete aufrufen, um den Client und NDIS darüber zu informieren, dass der Versuch, eine Partei auf der Multipoint-VC hinzuzufügen, abgeschlossen wurde, unabhängig davon, ob erfolgreich oder mit einem vom MCM-Treiber ermittelten Fehler status.

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

Wenn das zugrunde liegende Netzwerkmedium keine parteispezifischen Datenverkehrsparameter für Mehrpunkt-VCs 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 übereinstimmt:

Setzen Sie die Datenverkehrsparameter auf die Parameter zurück, die bereits für die Multipoint-VC eingerichtet wurden, wenn die Partei erfolgreich auf dieser Vc hinzugefügt wurde.
Ändern Sie die Datenverkehrsparameter für jede Partei, die bereits auf dem Nachweis vorhanden ist, wenn sie die neue Partei erfolgreich hinzufügt.
Lehnen Sie die Anforderung zum Hinzufügen einer neuen Partei ab. (Diese Alternative zwingt Clients implizit dazu, ihre Datenverkehrsparameter für eine Multipoint-VC mit NdisClMakeCall einzurichten und dieselben Datenverkehrsparameter bei jedem nachfolgenden Aufruf von NdisClAddParty für die angegebene Multipoint-VC anzugeben.)

Wenn der MCM-Treiber Status auf NDIS_STATUS_SUCCESS festlegt, muss er beim Aufrufen von NdisMCmAddPartyComplete ein explizites Handle bereitstellen, bei dem es sich in der Regel um einen Zeiger auf den vom Treiber zugewiesenen Statusbereich pro Partei handelt.

Ein Aufruf von NdisMCmAddPartyComplete bewirkt, dass NDIS die des Clients aufruft. ProtocolClAddPartyComplete-Funktion .

Nur verbindungsorientierte Miniporttreiber, die unterstützung für die integrierte Anrufverwaltung bieten, können NdisMCmAddPartyComplete aufrufen. Eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, rufen stattdessen NdisCmAddPartyComplete auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (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
Kopfzeile	ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_MCM_Function(ndis)