NdisCmDispatchIncomingDropParty-Funktion (ndis.h)

  • Artikel

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)

Weitere Informationen

NdisClDropParty

NdisCmDispatchIncomingCloseCall NdisMCmDispatchIncomingDropParty

ProtocolClIncomingDropParty

ProtocolCoReceiveNetBufferLists