NdisCmDispatchIncomingCallQoSChange-Funktion (ndis.h)

Artikel
02/29/2024

NdisCmDispatchIncomingCallQoSChange benachrichtigt einen Client, dass eine Anforderung zum Ändern der Dienstqualität für die aktive Verbindung dieses Clients über das Netzwerk empfangen wurde.

Syntax

void NdisCmDispatchIncomingCallQoSChange(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parameter

[in] NdisVcHandle

Gibt das Handle für den Nachweis an, für den die Änderung in QoS angefordert wird. Der Aufruf-Manager hat dieses Handle ursprünglich abgerufen, wenn er NdisCoCreateVc aufgerufen hat, um diese Verbindung für einen eingehenden Aufruf einzurichten, oder als Eingabeparameter für seine ProtocolCoCreateVc-Funktion .

[in] CallParameters

Zeiger auf eine Struktur vom Typ CO_CALL_PARAMETERS , die die neue QoS angibt, die vom Client auf dem Remoteknoten für diese Verbindung angefordert wird.

Rückgabewert

Keine

Bemerkungen

Ein eigenständiger Anruf-Manager ruft NdisCmDispatchIncomingCallQoSChange auf, um den Client zu benachrichtigen, dass er eine Anforderung zum Ändern der QoS für eine aktive Verbindung erhalten hat. Ein solcher CM unterstützt dynamische QoS-Änderungen bei aktiven Aufrufen. Hierbei handelt es sich um ein Feature wie QoS selbst, das vom Signalisierungsprotokoll abhängt.

Wenn der CM selbst eine Anforderung für eine QoS-Änderung empfängt, übergibt der Aufruf-Manager entsprechend geänderte Aufrufparameter an NdisCmActivateVc, sodass der zugrunde liegende Miniporttreiber auch über die vorgeschlagene QoS-Änderung benachrichtigt wird. Wenn der zugrunde liegende Miniporttreiber die geänderten Aufrufparameter akzeptiert, ruft der CM dann NdisCmDispatchIncomingCallQoSChange auf.

Ein Aufruf von NdisCmDispatchIncomingCallQoSChange bewirkt, dass NDIS die ProtocolClIncomingQoSChange-Funktion des Clients aufruft . Der Client akzeptiert die vorgeschlagenen Änderungen an den Aufrufparametern für die Vc, indem er nichts tut, außer möglicherweise einen Zustand zu aktualisieren, den er über die QoS für die Vc verwaltet, und gibt die Steuerung zurück. Andernfalls lehnt der Client die vorgeschlagene QoS-Änderung ab, indem er den Aufruf abreißt.

Nur eigenständige Anrufmanager, die sich bei NDIS als Protokolltreiber registrieren, können NdisCmDispatchIncomingCallQoSChange aufrufen. Verbindungsorientierte Miniporttreiber, die integrierte Unterstützung für die Anrufverwaltung bereitstellen, rufen stattdessen NdisMCmDispatchIncomingCallQoSChange an.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)) in Windows XP.
Zielplattform	Desktop
Kopfzeile	ndis.h (include Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_CallManager_Function(ndis)