NdisMCmDispatchIncomingDropParty-Makro (ndis.h)
NdisMCmDispatchIncomingDropParty benachrichtigt einen Client, dass er eine bestimmte Partei auf einem Multipoint VC entfernen sollte.
void NdisMCmDispatchIncomingDropParty(
_S_,
_H_,
_B_,
_Z_
);
_S_
Gibt 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 den Handle an, mit dem die Partei identifiziert wird, die aus dem Multipoint VC entfernt 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_
Zeigen Sie auf einen vom Aufrufer zugewiesenen Residentpuffer mit zusätzlichen protokollspezifischen Daten, die von der Remotepartei empfangen wurden, falls vorhanden. Je nach zugrunde liegendem Medium kann dieser Zeiger NULL-sein.
_Z_
Gibt die Größe in Byte des Puffers an, null, wenn Puffer-NULL-ist.
Nichts
Im Laufe der normalen Netzwerkvorgänge ruft ein MCM-Treiber NdisMCmDispatchIncomingDropParty mit dem CloseStatus- auf NDIS_STATUS_SUCCESS festgelegt, da ein Remoteclient in einer Multipoint-Verbindung NdisClCloseCallaufgerufen wurde.
Ein MCM-Treiber kann jedoch auch NdisMCmDispatchIncomingDropParty mit einem treiberbestimmten CloseStatus- am besten aufrufen, wenn ungewöhnliche Netzwerkbedingungen auftreten, z. B. das Ausfall eines Switches auf dem Pfad zwischen dem lokalen Client und einem oder mehreren Clients in einer etablierten Multipointverbindung.
Ein Aufruf von NdisMCmDispatchIncomingDropParty bewirkt, dass NDIS den Client aufruft ProtocolClIncomingDropParty Funktion.
Wenn die NdisPartyHandle die letzte verbleibende Partei auf dem angegebenen VC identifiziert, ruft der MCM-Treiber NdisMCmDispatchIncomingCloseCallanstelle NdisMCmDispatchIncomingDropParty.
Nur verbindungsorientierte Miniporttreiber, die integrierte Anrufverwaltungsunterstützung bieten, können NdisMCmDispatchIncomingDropPartyanrufen. Eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, rufen sie stattdessen NdisDispatchIncomingDropParty auf.
| Anforderung | Wert |
|---|---|
| mindestens unterstützte 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 |
| Header- | ndis.h (include Ndis.h) |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_MCM_Function(ndis) |