NdisCmDispatchIncomingDropParty-Funktion (ndis.h)
NdisCmDispatchIncomingDropParty benachrichtigt einen Client, dass er eine bestimmte Partei auf einer Multipoint-VC entfernen soll, in der Regel, weil der Anruf-Manager eine Anforderung über das Netzwerk erhalten hat, eine aktive Mehrpunktverbindung zu schließen.
Syntax
void NdisCmDispatchIncomingDropParty(
[in] NDIS_STATUS DropStatus,
[in] NDIS_HANDLE NdisPartyHandle,
[in, optional] PVOID Buffer,
[in] UINT Size
);
Parameter
[in] DropStatus
Gibt den Grund an, warum diese Partei gelöscht wird, normalerweise NDIS_STATUS_SUCCESS, wenn die Remotepartei einfach angefordert hat, dass ihre Verbindung geschlossen wird.
[in] NdisPartyHandle
Gibt das Handle an, mit dem die Partei identifiziert wird, die aus der Mehrpunkt-VC gelöscht werden soll, wobei andere Parteien vorhanden sein müssen, die noch verbunden sind.
[in, optional] Buffer
Zeiger auf einen vom Aufrufer zugewiesenen residenten Puffer mit zusätzlichen protokollspezifischen Daten, die von der Remotepartei empfangen werden, falls vorhanden. Je nach zugrunde liegendem Medium kann dieser Zeiger NULL sein.
[in] Size
Gibt die Größe des Puffers in Bytes an, null, wenn PufferNULL ist.
Rückgabewert
Keine
Bemerkungen
Im rahmen des normalen Netzwerkbetriebs wird ein eigenständiger Anrufmanager Die ProtocolCoReceiveNetBufferLists-Funktion ruft NdisCmDispatchIncomingDropParty auf, wobei closeStatus auf NDIS_STATUS_SUCCESS festgelegt ist, da ein Remoteclient in einer Mehrpunktverbindung NdisClCloseCall aufgerufen hat.
Ein Anruf-Manager kann jedoch auch NdisCmDispatchIncomingDropParty mit einem cm-bestimmten CloseStatus auf Geheiß des Netzwerks selbst aufrufen, wenn ungewöhnliche Netzwerkbedingungen auftreten, z. B. beim Ausfall eines Switches auf dem Pfad zwischen dem lokalen Client und einem oder mehreren Clients in einer etablierten Mehrpunktverbindung.
Ein Aufruf von NdisCmDispatchIncomingDropParty bewirkt, dass NDIS den Client aufruft. ProtocolClIncomingDropParty-Funktion .
Wenn NdisPartyHandle die letzte verbleibende Partei auf der angegebenen VC identifiziert, ruft der CM auf. NdisCmDispatchIncomingCloseCall anstelle von NdisCmDispatchIncomingDropParty.
Nur eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, können NdisCmDispatchIncomingDropParty aufrufen. Verbindungsorientierte Miniporttreiber, die integrierte Unterstützung der Anrufverwaltung bieten, rufen stattdessen NdisMCmDispatchIncomingDropParty an.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisCmDispatchIncomingDropParty (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisCmDispatchIncomingDropParty (NDIS 5.1)) in Windows XP. |
| Zielplattform | Desktop |
| Kopfzeile | ndis.h (einschließlich Ndis.h) |
| Bibliothek | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_CallManager_Function(ndis) |