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) |