NdisClModifyCallQoS-Funktion (ndis.h)
NdisClModifyCallQoS fordert eine Änderung der Dienstqualität für eine Verbindung an.
Syntax
NDIS_STATUS NdisClModifyCallQoS(
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
Parameter
[in] NdisVcHandle
Gibt das Handle für den Nachweis an, für den der Client die QoS ändern möchte. Der Client hat dieses Handle ursprünglich durch Aufrufen von NdisCoCreateVc abgerufen und vor kurzem dieses Handle aus seinem Pro-VC-Statusbereich abgerufen.
[in] CallParameters
Zeiger auf eine Struktur vom Typ CO_CALL_PARAMETERS, die die vom Aufrufer angeforderte neue QoS angibt.
Rückgabewert
Wenn NdisClModifyCallQoS etwas anderes als NDIS_STATUS_PENDING zurückgibt, sollte der Client einen internen Aufruf an seine ProtocolClModifyCallQoSComplete-Funktion . Andernfalls ruft NDIS die ProtocolClModifyCallQoSComplete-Funktion des Clients auf, wenn dieser Vorgang abgeschlossen ist.
Hinweise
Ein Aufruf von NdisClModifyCallQoS bewirkt, dass NDIS den CM aufruft. ProtocolCmModifyCallQoS-Funktion , die wiederum NdisCmActivateVc aufruft, um den zugrunde liegenden Miniporttreiber zu benachrichtigen, um die Aufrufparameter zu ändern, wenn die angeforderte QoS-Änderung vorgenommen werden kann.
Wenn der Anrufmanager die vom Client vorgeschlagene QoS-Änderung nicht akzeptiert, kann der Client entweder weiterhin die unveränderte QoS für den Anruf verwenden oder den Anruf beenden. Wenn sich der Kunde und der Anrufmanager nicht auf die QoS für einen bestimmten Anruf einigen können, ist der Ersteller des Nachweises dafür verantwortlich, den Abriss des Nachweises zu initiieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisClModifyCallQoS (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisClModifyCallQoS (NDIS 5.1)) in Windows XP. |
| Zielplattform | Desktop |
| Kopfzeile | ndis.h (include Ndis.h) |
| Bibliothek | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Protocol_Driver_Function(ndis) |