NdisClModifyCallQoS-Funktion (ndis.h)

Artikel
08/07/2023

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)