Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die ProtocolClCallConnected-Funktion wird von verbindungsorientierten NDIS-Clients verwendet, die eingehende Anrufe annehmen. Diese Clients müssen über ProtocolClCallConnected--Funktionen verfügen. Andernfalls kann die registrierte ProtocolClCallConnected-Funktion eines solchen Protokolltreibers einfach die Steuerung zurückgeben.
Note You must declare the function by using the PROTOCOL_CL_CALL_CONNECTED type.
Weitere Informationen finden Sie im folgenden Abschnitt "Beispiele".
Syntax
PROTOCOL_CL_CALL_CONNECTED ProtocolClCallConnected;
VOID ProtocolClCallConnected(
[in] NDIS_HANDLE ProtocolVcContext
)
{...}
Parameter
[in] ProtocolVcContext
Gibt das Handle des Clients für den Kontextbereich pro VC an. Der Client hat dieses Handle ursprünglich von der ProtocolCoCreateVc--Funktion an NDIS zurückgegeben.
Rückgabewert
Nichts
Bemerkungen
Wenn ProtocolClCallConnected- aufgerufen wird, hat der Anrufmanager erfolgreich den endgültigen Handshake für ein eingehendes Anrufangebot abgeschlossen, das zuvor von der ProtocolClIncomingCall-Funktion des Clients akzeptiert wurde, die bereits die Anrufparameter für diese Verbindung bei ProtocolVcContext eingerichtet hat.
Der Aufruf von ProtocolClCallConnected gibt an, dass Datenübertragungen, ob eingehende oder ausgehende, jetzt auf dem VC erfolgen können. ProtocolClCallConnected sollte sicherstellen, dass der Client bereit ist, Übertragungen auf dem VC vorzunehmen oder zu akzeptieren, bevor die Steuerung zurückgegeben wird.
beispiele für
Um eine ProtocolClCallConnected--Funktion zu definieren, müssen Sie zuerst eine Funktionsdeklaration bereitstellen, die den Typ der Funktion identifiziert, die Sie definieren. Windows stellt eine Reihe von Funktionstypen für Treiber bereit. Durch das Deklarieren einer Funktion mithilfe der Funktionstypen können Codeanalyse für Treiber, statische Treiberüberprüfung (SDV) und andere Überprüfungstools Fehler finden, und es ist eine Anforderung zum Schreiben von Treibern für das Windows-Betriebssystem.Um beispielsweise eine ProtocolClCallConnected--Funktion zu definieren, die den Namen "MyClCallConnected" hat, verwenden Sie den PROTOCOL_CL_CALL_CONNECTED Typ, wie in diesem Codebeispiel gezeigt:
PROTOCOL_CL_CALL_CONNECTED MyClCallConnected;
Implementieren Sie dann Ihre Funktion wie folgt:
_Use_decl_annotations_
VOID
MyClCallConnected(
NDIS_HANDLE ProtocolVcContext
)
{...}
Der PROTOCOL_CL_CALL_CONNECTED Funktionstyp wird in der Ndis.h-Headerdatei definiert. Um Fehler genauer zu identifizieren, wenn Sie die Codeanalysetools ausführen, müssen Sie der Funktionsdefinition die Use_decl_annotations Anmerkung hinzufügen. Die Use_decl_annotations Anmerkung stellt sicher, dass die Anmerkungen, die auf den Funktionstyp PROTOCOL_CL_CALL_CONNECTED in der Headerdatei angewendet werden, verwendet werden. Weitere Informationen zu den Anforderungen für Funktionsdeklarationen finden Sie unter Deklarieren von Funktionen mithilfe von Funktionsrollentypen für NDIS-Treiber.
Informationen zu Use_decl_annotationsfinden Sie unter Annotating Function Behavior.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe ProtocolClCallConnected (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe ProtocolClCallConnected (NDIS 5.1)) in Windows XP. |
| Zielplattform- | Fenster |
| Header- | ndis.h (include Ndis.h) |
| IRQL- | <= DISPATCH_LEVEL |