Freigeben über


NdisCmAddPartyComplete-Funktion (ndis.h)

NdisCmAddPartyComplete den endgültigen Status der Anforderung eines Clients zurück, für die der Anrufmanager zuvor NDIS_STATUS_PENDING zurückgegeben hat, um eine Partei zu einer etablierten 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 den endgültigen Status des Add-Party-Vorgangs des Anrufmanagers an, entweder NDIS_STATUS_SUCCESS oder eines NDIS_STATUS_XXX- außer NDIS_STATUS_PENDING.

[in] NdisPartyHandle

Gibt den Handle an, der die Partei identifiziert. Dieses Handle wurde an die ProtocolCmAddParty-Funktion des Anrufmanagers 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- werden, 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 bereitgestellt wurden, damit der Anbieter hinzugefügt werden kann.

Rückgabewert

Nichts

Bemerkungen

Wenn die ProtocolCmAddParty-Funktion eines eigenständigen Anrufmanagers NDIS_STATUS_PENDING zurückgibt, muss die CM-Funktion anschließend NdisCmAddPartyComplete- 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 Fehler abgeschlossen wurde.

Wenn der Client bei CallParameters, die nicht mit denen übereinstimmen, die für den Multipoint-VC bereits eingerichtet wurden, muss der Designer des Anrufmanagers bestimmen, wie diese Bedingung behandelt werden soll, vorbehaltlich der vom Netzwerkmedium auferlegten Einschränkungen. Folgende Möglichkeiten sind möglich:

  • Richten Sie die Datenverkehrsparameter pro Partei ein, wenn das zugrunde liegende Netzwerkmedium dieses Feature auf multipoint-VCs unterstützt.
  • Setzen Sie die vom Client bereitgestellten Datenverkehrsparameter auf diejenigen zurück, die für die VC eingerichtet wurden, wenn der ursprüngliche ausgehende Aufruf vor den CM-Aufrufen NdisCmAddPartyComplete mit NDIS_STATUS_SUCCESS als Status.
  • Ändern Sie die Datenverkehrsparameter für die VC und für jede parteiinterne Verbindung mit dem Client an die vom Client bereitgestellten Werte, bevor die CM-Aufrufe NdisCmAddPartyComplete mit NDIS_STATUS_SUCCESS als Status.
  • Fehler beim Versuch des Clients, eine Partei hinzuzufügen. (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.)
Für einige verbindungsorientierte Medien sind Verkehrsparameter pro VC in der Natur und folglich für alle Parteien auf einem Multipoint VC identisch.

Wenn der CM Status auf NDIS_STATUS_SUCCESS festlegt, muss er ein explizites Handle bereitstellen, das in der Regel ein Zeiger auf den cm zugewiesenen Statusbereich pro Partei ist, wie CallMgrPartyContext, wenn es NdisCmAddPartyCompleteaufruft.

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

Nur eigenständige Anrufmanager, die sich selbst bei NDIS als Protokolltreiber registrieren, können NdisCmAddPartyCompleteaufrufen. Verbindungsorientierte Miniporttreiber, die stattdessen integrierte Anrufverwaltungsunterstützung NdisMCmAddPartyComplete bereitstellen.

Anforderungen

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

Siehe auch

CO_CALL_PARAMETERS

NdisAllocateFromNPagedLookasideList

NdisClAddParty

NdisMCmAddPartyComplete

ProtocolClAddPartyComplete-

ProtocolCmAddParty-