NdisMCmDispatchIncomingDropParty-Makro (ndis.h)

NdisMCmDispatchIncomingDropParty benachrichtigt einen Client, dass er eine bestimmte Partei auf einer Multipoint-VC entfernen soll.

Syntax

void NdisMCmDispatchIncomingDropParty(
   _S_,
   _H_,
   _B_,
   _Z_
);

Parameter

_S_

Gibt den Grund an, warum diese Partei gelöscht wird, in der Regel NDIS_STATUS_SUCCESS, wenn die Remotepartei einfach angefordert hat, dass ihre Verbindung geschlossen wird.

_H_

Gibt das Handle an, das die Partei identifiziert, die aus der Multipoint-VC gelöscht werden soll, die über andere Parteien verfügen muss, die noch verbunden sind. Der MCM-Treiber hat dieses Handle ursprünglich als Eingabeparameter für seine ProtocolCmAddParty-Funktion abgerufen.

_B_

Zeiger auf einen vom Aufrufer zugewiesenen residenten Puffer mit zusätzlichen protokollspezifischen Daten, die von der Remotepartei empfangen werden(sofern vorhanden). Abhängig vom zugrunde liegenden Medium kann dieser Zeiger NULL sein.

_Z_

Gibt die Größe des Puffers in Byte an, null, wenn BufferNULL ist.

Rückgabewert

Keine

Bemerkungen

Bei normalen Netzwerkvorgängen ruft ein MCM-Treiber NdisMCmDispatchIncomingDropParty auf, wobei closeStatus auf NDIS_STATUS_SUCCESS festgelegt ist, da ein Remoteclient über eine Mehrpunktverbindung NdisClCloseCall aufgerufen hat.

Ein MCM-Treiber kann jedoch auch NdisMCmDispatchIncomingDropParty mit einem vom Treiber bestimmten CloseStatus auf Geheiß des Netzwerks selbst aufrufen, wenn ungewöhnliche Netzwerkbedingungen auftreten, z. B. der Ausfall eines Switches auf dem Pfad zwischen dem lokalen Client und einem oder mehreren Clients bei einer hergestellten Mehrpunktverbindung.

Ein Aufruf von NdisMCmDispatchIncomingDropParty bewirkt, dass NDIS die des Clients aufruft. ProtocolClIncomingDropParty-Funktion .

Wenn die NdisPartyHandle die letzte verbleibende Partei auf der angegebenen Vc identifiziert, ruft der MCM-Treiber auf. NdisMCmDispatchIncomingCloseCall anstelle von NdisMCmDispatchIncomingDropParty.

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

Anforderungen

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

Weitere Informationen

MiniportInterruptDPC

NdisClDropParty

NdisCmDispatchIncomingDropParty NdisMCmDispatchIncomingCloseCall

ProtocolClIncomingDropParty