NdisCmDispatchIncomingCall-Funktion (ndis.h)

Artikel
02/07/2025

NdisCmDispatchIncomingCall informiert den Kunden über einen eingehenden Anruf an 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 den Handle an, der sap identifiziert. NDIS richtet dieses Handle ein, wenn der Client ursprünglich NdisClRegisterSap-aufgerufen hat und der Anrufmanager dieses Handle ursprünglich als Eingabeparameter für seine ProtocolCmRegisterSap--Funktion.

[in] NdisVcHandle

Gibt den Handle an, der das VC identifiziert, das mit NdisCoCreateVc erstellt wurde, wenn der Anrufmanager das eingehende Anrufangebot verarbeitet, das an diesen registrierten SAP weitergeleitet wird.

[in] CallParameters

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

Rückgabewert

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

Bemerkungen

Vor dem Aufrufen von NdisCmDispatchIncomingCallhat bereits ein eigenständiger Anrufmanager Folgendes ausgeführt:

Identifizierte das ziel-SAP, das zuvor von einem bestimmten Client registriert wurde, für den Anruf (tatsächlich eine Anforderung zur Herstellung einer Verbindung), die er über das Netzwerk empfangen hat.
Erstellt eine VC für den eingehenden Anruf mit NdisCoCreateVc-
Möglicherweise wurde über akzeptable Anrufparameter über das Netzwerk verhandelt oder die vom Remoteknoten gesendeten Anrufparameter akzeptiert.
Aktivierte den VC mit NdisCmActivateVc, wodurch sich der zugrunde liegende Miniporttreiber für Übertragungen auf dem VC im Einklang mit den ausgehandelten oder akzeptierten Anrufparametern bereit macht.

Der CM-Aufruf von NdisCmDispatchIncomingCall- bewirkt, dass NDIS die ProtocolClIncomingCall--Funktion des Clients aufruft, in der der Client die angeforderte Verbindung akzeptiert oder ablehnt. Nach der Entscheidung, ob die Verbindung akzeptiert werden soll, ruft der Client NdisClIncomingCallCompleteauf, der wiederum die CM aufruft. ProtocolCmIncomingCallComplete-Funktion. Wenn der Client den Anruf angenommen hat, ruft der CM-Aufruf NdisCmDispatchCallConnectedauf. Andernfalls wird die erstellte VC deaktiviert (und möglicherweise gelöscht), nachdem der Remoteknoten benachrichtigt wurde, dass der angebotene Anruf abgelehnt wurde.

Nur eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, können NdisCmDispatchIncomingCallaufrufen. Verbindungsorientierte Miniporttreiber, die stattdessen integrierte Call-Management-Supportanrufe NdisMCmDispatchIncomingCall- bereitstellen.

Anforderungen

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