PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE Rückruffunktion (ndis.h)

  • Artikel

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 vom Protokolltreiber registrierte ProtocolClIncomingCallQoSChange-Funktion einfach die Steuerung zurückgeben.

Hinweis Sie müssen die Funktion mit dem typ 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 das Handle für den Kontextbereich pro VC des Clients für den Vc an, für den eine Anforderung zum Ändern der Dienstqualität über das Netzwerk eingegangen ist.

[in] CallParameters

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

Rückgabewert

Keine

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 akzeptieren, indem er einfach die Steuerung zurückgibt. Anderenfalls:
ProtocolClIncomingCallQoSChange sollte den Aufruf mit NdisClCloseCall abbrechen.

Beispiele

Um eine ProtocolClIncomingCallQoSChange-Funktion zu definieren, müssen Sie zunächst eine Funktionsdeklaration bereitstellen, die den Typ der von Ihnen definierten Funktion identifiziert. Windows bietet eine Reihe von Funktionstypen für Treiber. 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 Voraussetzung für das Schreiben von Treibern für das Windows-Betriebssystem.

Um beispielsweise eine ProtocolClIncomingCallQoSChange-Funktion mit dem Namen "MyClIncomingCallQoSChange" zu definieren, verwenden Sie den typ PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE , 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 ist in der Headerdatei Ndis.h definiert. Um Fehler beim Ausführen der Codeanalysetools genauer zu identifizieren, müssen Sie der Funktionsdefinition die anmerkung Use_decl_annotations hinzufügen. Die Use_decl_annotations-Anmerkung stellt sicher, dass die Anmerkungen verwendet werden, die auf den PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE 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 ProtocolClIncomingCallQoSChange (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe ProtocolClIncomingCallQoSChange (NDIS 5.1)) in Windows XP.
Zielplattform Windows
Kopfzeile ndis.h (include Ndis.h)
IRQL <= DISPATCH_LEVEL

Weitere Informationen

NdisClCloseCall

NdisClModifyCallQoS

ProtocolCmModifyCallQoS