NdisClMakeCall-Funktion (ndis.h)
NdisClMakeCall richtet einen ausgehenden Anruf auf einer vom Client erstellten VC ein.
Syntax
NDIS_STATUS NdisClMakeCall(
[in] NDIS_HANDLE NdisVcHandle,
[in, out] PCO_CALL_PARAMETERS CallParameters,
[in, optional] NDIS_HANDLE ProtocolPartyContext,
[out, optional] PNDIS_HANDLE NdisPartyHandle
);
Parameter
[in] NdisVcHandle
Gibt das handle an, das von einem vorherigen Aufruf von NdisCoCreateVczurückgegeben wird.
[in, out] CallParameters
Zeigen Sie auf eine Struktur vom Typ CO_CALL_PARAMETERS, in der der Aufrufer die Attribute für diese Verbindung angegeben hat, z. B. die Adresse des Ziels für den Anruf, die Latenz, bandbreite und die Dienstqualität, wenn die vom Anrufmanager unterstützte Netzwerkmedium- und Adressfamilie QoS-Spezifikationen zulässt.
[in, optional] ProtocolPartyContext
Gibt optional einen vom Anrufer bereitgestellten Handle für einen residenten Kontextbereich an, in dem der Client den Status pro Partei für die erste Partei auf seinem Multipoint VC verwaltet. Dieser Parameter ist NULL-, wenn die angegebene VC keine Multipointverbindung darstellt. Bei einem Multipoint-VC übergibt NDIS dieses Handle an die ProtocolCl-Xxx--Funktionen des Clients in allen nachfolgenden Aufrufen, die sich auf diese bestimmte Partei auswirken.
[out, optional] NdisPartyHandle
Zeiger auf eine vom Aufrufer bereitgestellte Variable, in der Regel im Kontextbereich der vom Anrufer zugewiesenen Partei, in dem NDIS ein Handle zurückgibt, das die erste Partei für die Multipointverbindung darstellt, wenn die Anforderung zum Einrichten eines ausgehenden Anrufs erfolgreich ist. Wenn ProtocolPartyContext-NULL-ist, wird diese Variable normalerweise im VC-Kontextbereich des Clients auf NULL- nach Abschluss der Einrichtung ausgehender Anrufe festgelegt.
Rückgabewert
Wenn NdisClMakeCall alles andere zurückgibt als NDIS_STATUS_PENDING, sollte der Client einen internen Anruf an seinen ProtocolClMakeCallComplete--Funktion. Andernfalls ruft NDIS die ProtocolClMakeCallComplete--Funktion des Clients auf, wenn dieser Vorgang abgeschlossen ist.
Bemerkungen
NdisClMakeCall- richtet die Attribute eines vom Client erstellten VC für einen clientinitiierte ausgehenden Anruf ein. Der Client muss die VC mit NdisCoCreateVc- einrichten, bevor versucht wird, einen ausgehenden Anruf zu tätigen.
Ein Aufruf von NdisClMakeCall bewirkt, dass NDIS diese Anforderung an die ProtocolCmMakeCall Funktion des Anrufmanagers weiterleite, mit dem der Client den angegebenen NdisVcHandleteilt. Der CM ist für die Überprüfung der angegebenen Daten bei CallParameters verantwortlich. Sie kann diese vom Client bereitgestellten Daten ändern, während sie mit relevanten Netzwerkkomponenten verhandeln und unterschiedliche Datenverkehrsparameter zurückgeben können, als der Client ursprünglich an NdisClMakeCallübergeben hat. Der Client ProtocolClMakeCallComplete--Funktion ist für die Annahme der geänderten Aufrufparameter verantwortlich, wenn dies auftritt oder um den Aufruf abreißen zu können, wenn die vorgeschlagenen Aufrufparameter der CM inakzeptabel sind.
Folglich müssen die Daten bei CallParameters mindestens für die Dauer der Anrufeinrichtung für den Anrufmanager verfügbar bleiben. Der Client kann diesen Puffer nicht freigeben, wenn NdisClMakeCall- NDIS_STATUS_PENDING zurückgibt. Sie muss die Freigabe dieser clientverteilten Ressource zurückstellen, bis die ProtocolClMakeCallComplete--Funktion aufgerufen wird.
Wenn NdisClMakeCall eine Mehrpunktverbindung einrichte, richtet der Client global die Datenverkehrsparameter für die angegebene VC ein, es sei denn, das zugrunde liegende Netzwerkmedium unterstützt Pro-Party-Datenverkehrsparameter.
Die ProtocolClMakeCallComplete--Funktion des Clients sollte die Eingabe Status auf NDIS_STATUS_SUCCESS überprüfen, bevor ein zurückgegebenes Handle bei NdisPartyHandle verwendet wird. Wenn der Anrufmanager die Anforderung zum Einrichten eines Anrufs für eine Multipointverbindung nicht erfüllt, ist der Wert dieser vom Client bereitgestellten Variable ungültig.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisClMakeCall (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisClMakeCall (NDIS 5.1)) in Windows XP. |
| Zielplattform- | Desktop |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Protocol_Driver_Function(ndis) |