PROTOCOL_CL_CALL_CONNECTED Rückruffunktion (ndis.h)

Artikel
02/29/2024

Die ProtocolClCallConnected-Funktion wird von verbindungsorientierten NDIS-Clients verwendet, die eingehende Anrufe annehmen. Solche Clients müssen über ProtocolClCallConnected-Funktionen verfügen . Andernfalls kann die registrierte ProtocolClCallConnected-Funktion eines solchen Protokolltreibers einfach die Steuerung zurückgeben.

Hinweis Sie müssen die Funktion mit dem PROTOCOL_CL_CALL_CONNECTED-Typ deklarieren. 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 jeweiligen VC-Kontextbereich an. Der Client hat dieses Handle ursprünglich von seiner ProtocolCoCreateVc-Funktion an NDIS zurückgegeben.

Rückgabewert

Keine

Bemerkungen

Wenn ProtocolClCallConnected aufgerufen wird, hat der Anruf-Manager den letzten Handshake für ein eingehendes Anrufangebot erfolgreich abgeschlossen, das zuvor von der ProtocolClIncomingCall-Funktion des Clients akzeptiert wurde, die bereits die Aufrufparameter für diese Verbindung unter ProtocolVcContext eingerichtet hat.

Der Aufruf von ProtocolClCallConnected gibt an, dass Datenübertragungen, egal ob eingehender oder ausgehender, jetzt auf der VC durchgeführt werden können. ProtocolClCallConnected sollte sicherstellen, dass der Client bereit ist, Übertragungen auf der VC durchzuführen oder zu akzeptieren, bevor er die Steuerung zurückgibt.

Beispiele

Um eine ProtocolClCallConnected-Funktion zu definieren, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die den Typ der zu definierenden Funktion identifiziert. Windows stellt eine Reihe von Funktionstypen für Treiber bereit. Das Deklarieren einer Funktion mithilfe der Funktionstypen hilft der Codeanalyse für Treiber, der statischen Treiberüberprüfung (Static Driver Verifier , SDV) und anderen Überprüfungstools, Fehler zu finden, und es ist eine Anforderung zum Schreiben von Treibern für das Windows-Betriebssystem.

Um beispielsweise eine ProtocolClCallConnected-Funktion mit dem Namen "MyClCallConnected" zu definieren, verwenden Sie den typ PROTOCOL_CL_CALL_CONNECTED , 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 ist in der Headerdatei Ndis.h definiert. Um Fehler beim Ausführen der Codeanalysetools genauer zu identifizieren, fügen Sie der Funktionsdefinition die Use_decl_annotations Anmerkung hinzu. Die Use_decl_annotations Anmerkung stellt sicher, dass die Anmerkungen verwendet werden, die auf den PROTOCOL_CL_CALL_CONNECTED Funktionstyp in der Headerdatei angewendet 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_annotations finden Sie unter Verhalten von Funktionen mit Anmerkungen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (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	Windows
Kopfzeile	ndis.h (einschließlich Ndis.h)
IRQL	<= DISPATCH_LEVEL