PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE Rückruffunktion (ndis.h)
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.
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 |