PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE Rückruffunktion (ndis.h)

Artikel
02/07/2025

Die ProtocolClIncomingCallQoSChange-Funktion wird von verbindungsorientierten Clients in Netzwerken verwendet, die dynamische Dienstqualität unterstützen. Solche Clients müssen über ProtocolClIncomingCallQoSChange Funktionen verfügen. Andernfalls kann die registrierte ProtocolClIncomingCallQoSChange--Funktion einfach die Steuerung zurückgeben.

Hinweis Sie müssen die Funktion mithilfe des typs PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE deklarieren. Weitere Informationen finden Sie im folgenden Abschnitt "Beispiele".

Syntax

PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE ProtocolClIncomingCallQosChange;

void ProtocolClIncomingCallQosChange(
  [in] NDIS_HANDLE ProtocolVcContext,
  [in] PCO_CALL_PARAMETERS CallParameters
)
{...}

Parameter

[in] ProtocolVcContext

Gibt den Handle für den Kontextbereich des Clients pro VC für die VC an, für den eine Anforderung zum Ändern der Dienstqualität über das Netzwerk erfolgt ist.

[in] CallParameters

Zeiger auf einen Puffer, formatiert als CO_CALL_PARAMETERS Struktur, die die neue QoS-Spezifikation enthält.

Rückgabewert

Nichts

Bemerkungen

Ein Aufruf von ProtocolClIncomingCallQoSChange gibt dem Client an, dass ein Remotepeer eine Änderung der Dienstqualität für diesen Aufruf angefordert hat. Die neue Dienstqualität wird unter CallParameters beschrieben. Der Client kann die angeforderte Änderung annehmen, indem er einfach die Steuerung zurückgibt. Sonst
ProtocolClIncomingCallQoSChange sollte den Aufruf mit NdisClCloseCall-abreißen.

beispiele für

Um eine ProtocolClIncomingCallQoSChange--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 ProtocolClIncomingCallQoSChange--Funktion zu definieren, die den Namen "MyClIncomingCallQoSChange" hat, verwenden Sie den PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE Typ, wie in diesem Codebeispiel gezeigt:

PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE MyClIncomingCallQoSChange;

Implementieren Sie dann Ihre Funktion wie folgt:

_Use_decl_annotations_
VOID
 MyClIncomingCallQoSChange(
    NDIS_HANDLE  ProtocolVcContext,
    PCO_CALL_PARAMETERS  CallParameters
    )
  {...}

Der PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE 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 PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE Funktionstyp 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 ProtocolClIncomingCallQoSChange (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe ProtocolClIncomingCallQoSChange (NDIS 5.1)) in Windows XP.
Zielplattform-	Fenster
Header-	ndis.h (include Ndis.h)
IRQL-	<= DISPATCH_LEVEL

Siehe auch

NdisClCloseCall

NdisClModifyCallQoS-

ProtocolCmModifyCallQoS-

Freigeben über