NdisCmAddPartyComplete-Funktion (ndis.h)

Artikel
02/29/2024

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

Syntax

void NdisCmAddPartyComplete(
  [in]           NDIS_STATUS         Status,
  [in]           NDIS_HANDLE         NdisPartyHandle,
  [in, optional] NDIS_HANDLE         CallMgrPartyContext,
  [in]           PCO_CALL_PARAMETERS CallParameters
);

Parameter

[in] Status

Gibt die endgültige status des Add-Party-Vorgangs des Anruf-Managers an, entweder NDIS_STATUS_SUCCESS oder ein beliebiger NDIS_STATUS_XXX außer NDIS_STATUS_PENDING.

[in] NdisPartyHandle

Gibt das Handle an, das die Partei identifiziert. Dieses Handle wurde für die ProtocolCmAddParty-Funktion des Aufrufmanagers eingegeben.

[in, optional] CallMgrPartyContext

Gibt das Handle für einen vom Anrufer zugewiesenen residenten Kontextbereich an, in dem der Anrufmanager parteispezifische Statusinformationen verwaltet, wenn der Add-Party-Vorgang erfolgreich war. Andernfalls kann dieser Parameter NULL sein, da er ignoriert wird.

[in] CallParameters

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 eigenständigen Aufruf-Managers NDIS_STATUS_PENDING zurückgibt, muss der CM anschließend NdisCmAddPartyComplete aufrufen, um den Client und NDIS darüber zu benachrichtigen, dass der Versuch, eine Partei auf der Multipoint-VC hinzuzufügen, erfolgreich oder mit einem Fehler abgeschlossen wurde.

Wenn der Client Datenverkehrsparameter an CallParameters übergeben hat, die nicht mit denen übereinstimmen, die bereits für die Multipoint-VC festgelegt wurden, muss der Designer des Aufruf-Managers bestimmen, wie diese Bedingung behandelt werden soll, vorbehaltlich aller Einschränkungen, die vom Netzwerkmedium auferlegt werden. Überprüfen Sie die folgenden Möglichkeiten:

Richten Sie die Pro-Partei-Datenverkehrsparameter ein, wenn das zugrunde liegende Netzwerkmedium dieses Feature auf Multipoint-VCs unterstützt.
Setzen Sie die vom Client bereitgestellten Datenverkehrsparameter auf die Parameter zurück, die für den Vc eingerichtet wurden, wenn der ursprüngliche ausgehende Aufruf vor dem CM-Aufruf von NdisCmAddPartyComplete mit NDIS_STATUS_SUCCESS als Status ausgeführt wurde.
Ändern Sie die Datenverkehrsparameter für die Vc und für jede partei, die derzeit mit ihr verbunden ist, in die vom Client bereitgestellten Werte, bevor der CM NdisCmAddPartyComplete mit NDIS_STATUS_SUCCESS als Status aufruft.
Fehler beim Versuch des Clients, eine Partei hinzuzufügen. (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.)

Bei einigen verbindungsorientierten Medien sind die Verkehrsparameter pro VC naturgemäß und daher für alle Parteien auf einer Multipoint-VC identisch.

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

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

Nur eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, können NdisCmAddPartyComplete aufrufen. Verbindungsorientierte Miniporttreiber, die integrierte Unterstützung für die Anrufverwaltung bieten, rufen stattdessen NdisMCmAddPartyComplete an.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisCmAddPartyComplete (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisCmAddPartyComplete (NDIS 5.1)) in Windows XP.
Zielplattform	Desktop
Kopfzeile	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_CallManager_Function(ndis)