NdisCmDispatchIncomingCall-Funktion (ndis.h)

Artikel
08/07/2023

NdisCmDispatchIncomingCall informiert den Client über einen eingehenden Anruf bei einem SAP, der zuvor von diesem Client registriert wurde.

Syntax

NDIS_STATUS NdisCmDispatchIncomingCall(
  [in] NDIS_HANDLE         NdisSapHandle,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parameter

[in] NdisSapHandle

Gibt das Handle an, das sap identifiziert. NDIS hat dieses Handle eingerichtet, wenn der Client ursprünglich NdisClRegisterSap hieß und der Aufruf-Manager dieses Handle ursprünglich als Eingabeparameter für seine ProtocolCmRegisterSap-Funktion .

[in] NdisVcHandle

Gibt das Handle an, das den Nachweis identifiziert, der mit NdisCoCreateVc erstellt wird, wenn der Anrufmanager das an dieses registrierte SAP weitergeleitete Angebot für eingehende Anrufe verarbeitet.

[in] CallParameters

Zeiger auf eine Struktur vom Typ CO_CALL_PARAMETERS , die die Datenverkehrs- und Medienparameter für den Vc angibt.

Rückgabewert

Wenn NdisCmDispatchIncomingCall etwas anderes als NDIS_STATUS_PENDING zurückgibt, sollte der Anrufmanager einen internen Anruf an seine ProtocolCmIncomingCallComplete-Funktion . Andernfalls ruft NDIS die ProtocolCmIncomingCallComplete-Funktion des CM auf, wenn dieser Vorgang abgeschlossen ist.

Hinweise

Vor dem Aufruf von NdisCmDispatchIncomingCall hat ein eigenständiger Anrufmanager bereits Folgendes ausgeführt:

Identifiziert das ZIEL-SAP, das zuvor von einem bestimmten Client für den Anruf (eigentlich eine Anforderung zum Herstellen einer Verbindung) registriert wurde, den er über das Netzwerk empfangen hat.
Erstellt eine Vc für den eingehenden Anruf mit NdisCoCreateVc
Möglicherweise wurde über akzeptable Aufrufparameter über das Netzwerk ausgehandelt oder die vom Remoteknoten gesendeten Aufrufparameter akzeptiert.
Aktivierte den Vc mit NdisCmActivateVc, wodurch sich der zugrunde liegende Miniporttreiber in Übereinstimmung mit den ausgehandelten oder akzeptierten Anrufparametern für Übertragungen auf dem Vc bereit macht.

Der Aufruf des CM an NdisCmDispatchIncomingCall bewirkt, dass NDIS die ProtocolClIncomingCall-Funktion des Clients aufruft, in der der Client die angeforderte Verbindung entweder akzeptiert oder ablehnt. Nachdem er entschieden hat, ob die Verbindung akzeptiert werden soll, ruft der Client NdisClIncomingCallComplete auf, der wiederum den CM aufruft. ProtocolCmIncomingCallComplete-Funktion . Wenn der Client den Anruf akzeptiert hat, ruft die CM als Nächstes NdisCmDispatchCallConnected auf. Andernfalls wird der erstellte Nachweis deaktiviert (und möglicherweise gelöscht), nachdem der Remoteknoten darüber informiert wurde, dass der angebotene Aufruf abgelehnt wurde.

Nur eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, können NdisCmDispatchIncomingCall aufrufen. Verbindungsorientierte Miniporttreiber, die integrierte Unterstützung für die Anrufverwaltung bieten, rufen stattdessen NdisMCmDispatchIncomingCall an .

Anforderungen

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