NdisMCmDispatchIncomingCall-Makro (ndis.h)

Artikel
08/07/2023

NdisMCmDispatchIncomingCall informiert den Client über einen eingehenden Anruf bei einem SAP, der zuvor vom Client mit dem MCM-Treiber registriert wurde.

Syntax

void NdisMCmDispatchIncomingCall(
   _SH_,
   _VH_,
   _CP_
);

Parameter

_SH_

Gibt das Handle an, das sap identifiziert. NDIS richtete dieses Handle ein, wenn der Client ursprünglich NdisClRegisterSap hieß und der MCM-Treiber dieses Handle als Eingabeparameter für seine ProtocolCmRegisterSap-Funktion .

_VH_

Gibt das Handle an, das die Vc identifiziert, die mit NdisMCmCreateVc erstellt wird, wenn der MCM-Treiber das an dieses registrierte SAP weitergeleitete Angebot für eingehende Anrufe verarbeitet.

_CP_

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

Rückgabewert

Keine

Bemerkungen

Vor dem Aufruf von NdisMCmDispatchIncomingCall hat ein MCM-Treiber 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 NdisMCmCreateVc
Möglicherweise wurde über akzeptable Aufrufparameter über das Netzwerk ausgehandelt oder die vom Remoteknoten gesendeten Aufrufparameter akzeptiert.
Aktivierte den Vc mit NdisMCmActivateVc , um NDIS zu benachrichtigen, dass er gemäß den ausgehandelten oder akzeptierten Anrufparametern für Übertragungen auf dem Vc bereit ist.

Der Aufruf des MCM-Treibers an NdisMCmDispatchIncomingCall 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 angenommen werden soll, ruft der Client NdisClIncomingCallComplete auf, was wiederum die ProtocolCmIncomingCallComplete-Funktion des MCM-Treibers aufruft. Wenn der Client den Anruf akzeptiert hat, ruft der MCM-Treiber als Nächstes auf. NdisMCmDispatchCallConnected. 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 verbindungsorientierte Miniporttreiber, die integrierte Unterstützung für die Anrufverwaltung bieten, rufen NdisMCmDispatchIncomingCall an. Eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, rufen stattdessen NdisCmDispatchIncomingCall auf .

Anforderungen

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